Resend CLI

Консольная утилита resend отправляет письма, управляет доменами, рассылками и вебхуками и отдает агенту результат в JSON

  • 411 ★ репозитория
  • Последний коммит
  • MIT
CLIОфициальный

Широкий доступ

Почему такой уровень

  • Отправляет реальные письма, рассылки и ответы от имени ваших доменов, и отправку нельзя отозвать
  • Управляет доменами, контактами, ключами, вебхуками и ящиками: у ящиков, цепочек и ярлыков есть команда `delete`
  • Хранит API-ключ в `~/.config/resend/credentials.json`, а скрипт установки выполняет загруженный код
Все причины и проверки

resend/resend-cli

Установка

Работает в

Ручная установка

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

Первый вариант из README. Положит бинарный файл в ~/.resend/bin/ (путь меняет RESEND_INSTALL).

Доступ и проверки

Как мы проверяем

Широкий доступИнструмент может менять данные, выполнять команды или работать с секретами.

  • Отправляет реальные письма, рассылки и ответы от имени ваших доменов, и отправку нельзя отозвать
  • Управляет доменами, контактами, ключами, вебхуками и ящиками: у ящиков, цепочек и ярлыков есть команда `delete`
  • Хранит API-ключ в `~/.config/resend/credentials.json`, а скрипт установки выполняет загруженный код

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Resend CLI — официальная консольная утилита сервиса Resend для отправки почты. Команда `resend emails send` отправляет письмо с текстом, HTML или файлом шаблона, с копиями, скрытыми копиями и адресом для ответа. Через те же команды ведут домены, контакты, рассылки, шаблоны, вебхуки, API-ключи, логи, автоматизации и события. Отдельная группа `resend inboxes` управляет ящиками на ваших доменах: цепочками писем, черновиками, ярлыками и настройками встроенного агента. Утилита писалась для людей, агентов и CI. Когда вывод идет в канал или флаг `--json`, она отдает только JSON, а ошибки печатает в stderr с полями `message` и `code` и кодом выхода 1. Команда `resend commands` печатает дерево всех команд в JSON, чтобы агент мог найти нужную. Флаг `--dry-run` проверяет письмо и показывает запрос, ничего не отправляя. Ключ берется из флага `--api-key`, переменной `RESEND_API_KEY` или файла `~/.config/resend/credentials.json` с правами 0600, а профили переключает `resend auth switch`. В репозиторий входит и скилл `skills/resend-cli/SKILL.md`: он описывает агентам неинтерактивные флаги, форматы вывода и типичные ошибки.

Для кого. Разработчикам, которые рассылают транзакционную и маркетинговую почту через Resend и хотят управлять сервисом из терминала, CI и агента без ручной работы в панели.

Подходит, если

  • Письмо о завершении деплоя уходит из GitHub Actions одной командой с ключом из секретов
  • Агент проверяет окружение командой `resend doctor` и видит, найден ли ключ и какие домены подтверждены
  • Шаблон письма на React Email отправляют на тестовый адрес `delivered@resend.dev` прямо из терминала
  • Вебхуки и контакты настраивают скриптом, и повторять эти шаги в панели не приходится
  • Агенту выдают отдельный ящик и поручают разбирать входящие письма и готовить черновики ответов

Не подходит, если

  • Почту вы отправляете через другой сервис: утилита работает только с API Resend
  • Нужен MCP-сервер: у Resend для него есть отдельный пакет, и эта утилита им не служит
  • Агент работает на общей машине, и выдавать ему полный API-ключ, которым можно менять и удалять ресурсы аккаунта, нельзя
  • Вам нужна проверка письма без запросов к сервису: вне `--dry-run` утилита ходит в API

Пример запроса к агенту

Проверь окружение через resend doctor, затем отправь тестовое письмо на delivered@resend.dev с темой «Проверка» и покажи id письма

Ограничения

Нужен ключ Resend, начинающийся на `re_`, и отправка идет только с домена, подтвержденного в аккаунте. Большинство команд для ящиков требуют ключ с полным доступом, а ключ только на отправку подходит для ответа, пересылки, создания и отправки черновиков. Ключ, ограниченный одним доменом, должен совпадать с доменом ящика. `--dry-run` работает лишь у `emails send`, `broadcasts create` и `emails batch`, остальные команды сразу выполняют действие. Отправленное письмо и удаление ресурса вернуть нельзя. В канале и CI вывод идет в JSON, в терминале форматированным текстом, поэтому в скриптах включайте `--json`. Скрипт установки `curl ... | bash` запускает загруженный код.

Как отключить. Выполните `npm uninstall -g resend-cli` или удалите бинарный файл из `~/.resend/bin/`, если ставили скриптом. Ключ и профили хранятся в `~/.config/resend/credentials.json`: удалите файл. Ключ в панели Resend отзовите отдельно, а скилл `resend-cli` уберите из каталога скиллов агента.

Частые вопросы

Как установить Resend CLI?

Скриптом: `curl -fsSL https://resend.com/install.sh | bash`. Можно через npm (`npm install -g resend-cli`), Homebrew (`brew install resend/cli/resend`) или PowerShell (`irm https://resend.com/install.ps1 | iex`), а также скачать `.exe` из релизов.

Откуда утилита берет API-ключ?

Сначала из флага `--api-key`, затем из переменной `RESEND_API_KEY`, потом из файла после `resend login`. Если ключа нет нигде, команда завершится ошибкой `auth_error`.

Как отправить письмо из CI?

Задайте `RESEND_API_KEY` из секретов и вызовите `resend emails send` с флагами `--from`, `--to`, `--subject` и одним из `--text`, `--html`, `--html-file`. Вход через `resend login` в CI не нужен.

Как агенту узнать список команд?

Выполнить `resend commands`: он печатает дерево команд с параметрами и описаниями в JSON. При запуске агентом утилита сама переключается на JSON, потому что вывод идет не в терминал.

Можно ли проверить письмо без отправки?

Да, добавьте `--dry-run` к `resend emails send`, `resend broadcasts create` или `resend emails batch --file`. Утилита выведет запрос и ничего не отправит; для пакетной проверки ключ не нужен.

Обсуждение

Вопросов и отзывов пока нет.

Официальный

Официальный MCP-сервер Resend: отправка и чтение писем, контакты, рассылки, домены и вебхуки из агента

MCP-серверШирокий доступ580Звезды репозитория

Hycli по адресу сайта и цели собирает типизированный CLI и MCP-инструменты, работая в вашей браузерной сессии без утечки куки.

CLIШирокий доступ470Звезды репозитория

Плагин и каталог CLI для агентов: генерирует командный интерфейс к GUI-программам вроде GIMP и Blender и ставит готовые через CLI-Hub

ПлагинШирокий доступ58,6 тыс.Звезды репозитория

Язык и рантайм для навыков, которые пишет агент, а утверждает человек: исполнение через разрешенные коннекторы и подписи

CLIШирокий доступ76Звезды репозитория

Open Agent Email — свой почтовый сервер для ИИ-агентов: ящики, ответы в ветке письма, одобрение человеком, вебхуки и MCP на 96 инструментов

MCP-серверШирокий доступ2,1 тыс.Звезды репозитория

Набор скиллов, которые учат агента работать с Gmail, Slack, HubSpot, Salesforce и другими приложениями через CLI Membrane

СкиллШирокий доступ272Звезды репозитория

Сравнение с похожими

Карточки с тем же главным запросом: чем они отличаются.

ИнструментОфициальныйАвторизацияЗвезды репозиторияГлавное отличие
Resend CLI (эта карточка)да411
Resend MCP ServerдаOAuth580MCP-сервер Resend для агента; CLI запускается из терминала и CI и работает с JSON
Скиллы ResendнетAPI-ключ212официальные скиллы Resend про почту, React Email и CLI; здесь сама утилита и ее встроенный скилл

Коротко о README

Страница начинается с четырех способов установки и быстрого старта из трех команд. Затем идут подробные разделы по командам с таблицами флагов и кодов ошибок, отдельно описаны вебхуки с типами событий и ящики, а в конце собраны глобальные флаги, поведение вывода и пути конфигурации.

Бейдж для README

Сообщить о проблеме