Resend CLI

Resend CLI

This repository (Asymmetric-al/core)

These repo-owned sections are intentionally kept on top of the vendored Resend CLI skill. If upstream refreshes replace this file, reconcile this overlay before running bun run skills:sync. App-level Resend integration lives in docs/guides/features/resend-integration.md; this skill is only for the terminal CLI, shell scripts, and CI automation.

Triggers

• Running, scripting, installing, or troubleshooting the resend CLI.
• Resend CLI work in local shells, CI/CD, automations, or non-interactive agent runs.
• Sending or previewing React Email templates through CLI flags.

Workflow

1. Confirm the task is CLI work; for product email routes, SDK, webhooks, or inbound handling, use docs/guides/features/resend-integration.md instead.
2. Check resend --version before invoking CLI commands.
3. Confirm required environment variables are available without printing secret values.
4. Use non-interactive flags and JSON-safe output patterns from this skill.
5. Verify the command result and capture sanitized IDs/status only.

Checklist

• Confirmed the task belongs to Resend CLI rather than app integration.
• Verified the resend binary and auth/env prerequisites.
• Avoided printing API keys, tokens, or full secret values.
• Used non-interactive flags suitable for agents/CI.
• Recorded sanitized command evidence or a clear blocker.

Installation

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

resend --version

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

cURL (macOS / Linux):

curl -fsSL https://resend.com/install.sh | bash

Homebrew (macOS / Linux):

brew install resend/cli/resend

Node.js:

npm install -g resend-cli

PowerShell (Windows):

irm https://resend.com/install.ps1 | iex

After installing, verify:

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:

  { "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

Available Commands

Read the matching reference file for detailed flags and output shapes.

Dry-run: Only emails send and broadcasts create support --dry-run (payload validation before send/create). They print { "dryRun": true, "request": { ... } } on stdout without calling the API. There is no --dry-run on emails batch, broadcasts send, or other commands yet.

Common Mistakes

Common Patterns

Send an email:

resend emails send --from "you@domain.com" --to user@example.com --subject "Hello" --text "Body"

Send a React Email template (.tsx):

resend emails send --from "you@domain.com" --to user@example.com --subject "Welcome" --react-email ./emails/welcome.tsx

Domain setup flow:

resend domains create --name example.com --region us-east-1
# Configure DNS records from output, then:
resend domains verify <domain-id>
resend domains get <domain-id>  # check status

Create and send a broadcast:

resend broadcasts create --from "news@domain.com" --subject "Update" --segment-id <id> --html "<h1>Hi</h1>" --send

CI/CD (no login needed):

RESEND_API_KEY=re_xxx resend emails send --from ... --to ... --subject ... --text ...

Check environment health:

resend doctor -q

When to Load References

• Sending or reading emails → references/emails.md
• Setting up or verifying a domain → references/domains.md
• Managing API keys → references/api-keys.md
• Creating or sending broadcasts → references/broadcasts.md
• Managing contacts, segments, or topics → references/contacts.md, references/segments.md, references/topics.md
• Defining contact properties → references/contact-properties.md
• Working with templates → references/templates.md
• Viewing API request logs → references/logs.md
• Creating automations or sending events → references/automations.md
• Setting up webhooks or listening for events → references/webhooks.md
• Auth, profiles, or health checks → references/auth.md
• Multi-step recipes (setup, CI/CD, broadcast workflow) → references/workflows.md
• Command failed with an error → references/error-codes.md
• Resend SDK integration (Node.js, Python, Go, etc.) → Install the resend skill
• AI agent email inbox → Install the agent-email-inbox skill