Resend Cli

# Resend CLI

## Installation

Before running any `resend` commands, check whether the CLI is installed:

```bash
resend --version
```

If the command is not found, install it using one of the methods below:

**cURL (macOS / Linux):**
```bash
curl -fsSL https://resend.com/install.sh | bash
```

**Homebrew (macOS / Linux):**
```bash
brew install resend/cli/resend
```

**Node.js:**
```bash
npm install -g resend-cli
```

**PowerShell (Windows):**
```powershell
irm https://resend.com/install.ps1 | iex
```

After installing, verify:
```bash
resend --version
```

## Agent Protocol

The CLI auto-detects non-TTY environments and outputs JSON — no `--json` flag needed.

**Rules for agents:**
- Supply ALL required flags. The CLI will NOT prompt when stdin is not a TTY.
- Pass `--quiet` (or `-q`) to suppress spinners and status messages.
- Exit `0` = success, `1` = error.
- Error JSON goes to stderr, success JSON goes to stdout:
  ```json
  {"error":{"message":"...","code":"..."}}
  ```
- Use `--api-key` or `RESEND_API_KEY` env var. Never rely on interactive login.
- All `delete`/`rm` commands require `--yes` in non-interactive mode.

## Authentication

Auth resolves: `--api-key` flag > `RESEND_API_KEY` env > config file (`resend login --key`). Use `--profile` or `RESEND_PROFILE` for multi-profile.

## Global Flags

| Flag | Description |
|------|-------------|
| `--api-key <key>` | Override API key for this invocation |
| `-p, --profile <name>` | Select stored profile |
| `--json` | Force JSON output (auto in non-TTY) |
| `-q, --quiet` | Suppress spinners/status (implies `--json`) |

## Available Commands

| Command Group | What it does |
|--------------|-------------|
| `emails` | send, get, list, batch, cancel, update |
| `emails receiving` | list, get, attachments, forward, listen |
| `domains` | create, verify, update, delete, list |
| `logs` | list, get, open |
| `api-keys` | create, list, delete |
| `autom