Introduction
# Resend CLI
CLI for the Resend email API. Query received (inbound) emails and attachments.
## Installation
```bash npm install -g @mjrussell/resend-cli ```
## Setup
1. Sign up at [resend.com](https://resend.com) 2. Set up inbound email routing for your domain 3. Create API key at API Keys → Create API key (needs read permissions) 4. Set environment variable: `export RESEND_API_KEY="re_your_key"`
## Commands
### List Emails
```bash resend email list # List recent emails (default 10) resend email list -l 20 # List 20 emails resend email list --json # Output as JSON ```
### Get Email Details
```bash resend email get <id> # Show email details resend email get <id> --json # Output as JSON ```
### Attachments
```bash resend email attachments <email_id> # List attachments resend email attachment <email_id> <attachment_id> # Get attachment metadata resend email attachments <email_id> --json # Output as JSON ```
### Domains
```bash resend domain list # List configured domains resend domain get <id> # Get domain details with DNS records resend domain list --json # Output as JSON ```
## Usage Examples
**User: "Do I have any new emails?"** ```bash resend email list -l 5 ```
**User: "Show me the latest email"** ```bash resend email list --json | jq -r '.data.data[0].id' # Get ID resend email get <id> ```
**User: "What attachments are on that email?"** ```bash resend email attachments <email_id> ```
**User: "What domains do I have set up?"** ```bash resend domain list ```
**User: "Show me the full content of email X"** ```bash resend email get <email_id> ```
## Notes
- This CLI only supports **received (inbound)** emails, not sending - Use `--json` flag and pipe to `jq` for scripting - Email IDs are UUIDs shown in list output