/resend-cli

Operate the Resend platform from the terminal — send emails (including React Email .tsx templates via --react-email), manage domains, contacts, broadcasts, templates, webhooks, API keys, logs, automations, and events via the `resend` CLI. Use when the user wants to run Resend commands in the shell, scripts, or CI/CD pipelines, or send/preview React Email templates. Always load this skill before running `resend` commands — it contains the non-interactive flag contract and gotchas that prevent silent failures.

18 files
73.6 KB
MIT
Updated 2 days ago
GitHub
1 warning

Ask your Agent

Use this Skill: https://skilld.dev/gh/resend/resend-skills/resend-cli

This session only. Nothing lands on disk.

referencesauth.md

1.4 KB raw

≈368 tokens on demand. Your agent reads this file only when SKILL.md points to it.

auth & utility

Detailed flag specifications for resend auth and utility commands.

auth login

Flag	Type	Required	Description
`--key <key>`	string	Yes (non-interactive)	API key (must start with `re_`)

Pass the key from an environment variable (e.g. --key "$RESEND_API_KEY") or a secret manager — never as a literal, which would persist in shell history and logs.

auth logout

Removes the active profile's credentials (or all profiles if no --profile).

auth list

Lists all profiles with active marker.

auth switch

Argument: [name] — Profile name (prompts in interactive if omitted)

auth rename

Arguments: [old-name] [new-name] — Prompts in interactive if omitted

auth remove

Argument: [name] — Profile name (prompts in interactive if omitted)

whoami

No flags. Shows authentication status (local only, no network calls).

doctor

Checks: CLI Version, API Key, Domains, AI Agents.

Exits 0 if all pass/warn, 1 if any fail.

update

Checks GitHub releases for newer version. Shows upgrade command.

open

Opens https://resend.com/emails in the default browser.

broadcasts and templates also have their own open subcommands:

resend broadcasts open [id] — open a broadcast or the broadcasts list
resend templates open [id] — open a template or the templates list

Source: SKILL.md on GitHub

Third-party checks

1 warning1d4 checks · Risk SAFE

Gen Agent Trust Hub1d
This skill provides a comprehensive CLI for managing the Resend email platform. It includes robust documentation on credential safety, preventing accidental API key exposure, and specifically warns agents about treating inbound email content as untrusted data. The skill is published by the official Resend team and uses standard development practices.
Socket1d
No alerts
Snyk1d
Risk: MEDIUM · 1 issue
ZeroLeaks5mo
1 finding · Score: 82/100

Provenance

Signed by skilld at edbfece. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 2 days ago.

Activeupdated 2 days ago

Capability

Other metadata

metadata: { "author": "resend", "version": "2.15.0", "homepage": "https://resend.com/docs/cli-agents", "source": "https://github.com/resend/resend-cli", "openclaw": { "primaryEnv": "RESEND_API_KEY", "requires": { "env": [ "RESEND_API_KEY" ], "bins": [ "resend" ] }, "envVars": [ { "name": "RESEND_API_KEY", "required": true, "description": "Resend API key for authenticating CLI commands" }, { "name": "RESEND_PROFILE", "required": false, "description": "Named auth profile for multi-account setups" } ], "install": [ { "kind": "node", "package": "resend-cli", "bins": [ "resend" ], "label": "Resend CLI" } ], "links": { "repository": "https://github.com/resend/resend-cli", "documentation": "https://resend.com/docs/cli" } } }
inputs: [ { "name": "RESEND_API_KEY", "description": "Resend API key for authenticating CLI commands. Get yours at https://resend.com/api-keys", "required": true }, { "name": "RESEND_PROFILE", "description": "Named auth profile for multi-account setups. Selects which stored API key to use (see `resend auth`).", "required": false } ]
references: [ "references/emails.md", "references/domains.md", "references/api-keys.md", "references/automations.md", "references/broadcasts.md", "references/contacts.md", "references/contact-properties.md", "references/segments.md", "references/templates.md", "references/topics.md", "references/logs.md", "references/careers.md", "references/suppressions.md", "references/webhooks.md", "references/auth.md", "references/workflows.md", "references/error-codes.md" ]

Topics

CLI
resend
email
react-email
domains
broadcasts
contacts
automations
webhooks
ci-cd

What it does

Operate the Resend email platform from the terminal—send emails via React Email templates, manage domains, contacts, broadcasts, templates, webhooks, API keys, and automations using the `resend` CLI. Targets shell scripts, CI/CD pipelines, and agent workflows that need programmatic email operations without interactive prompts.

Generated from the current SKILL.md.

Frequently asked

Does this skill work in non-interactive environments like CI/CD?

Yes. The CLI auto-detects non-TTY and outputs JSON without prompting. Set RESEND_API_KEY in the environment, use --quiet to suppress spinners, and pass --yes on all delete commands.

Can I send React Email .tsx templates with this skill?

Yes. Use `resend emails send --react-email ./path/to/template.tsx` along with required flags like --from, --to, and --subject.

What authentication methods does the CLI support?

The CLI resolves auth via --api-key flag, RESEND_API_KEY environment variable, or a stored profile (resend login). Use RESEND_PROFILE or --profile for multi-account setups.

Does this skill support dry-run validation?

Only `emails send` and `broadcasts create` support --dry-run. They validate the payload and print the request without calling the API. Other commands like `emails batch` and `broadcasts send` do not support dry-run.

What happens if I forget --yes on a delete command?

The CLI exits with an error in non-interactive mode and does not prompt. All delete/rm subcommands require --yes when stdin is not a TTY.

Generated from the current SKILL.md. These answers refresh after source changes.