База знаний
Командная строка
Ваш почтовый ящик и любая операция API из терминала или скрипта.
Подробности
- Команда
openemail, которая устанавливается из npm как@openemail/cli. Это один файл без зависимостей, ему нужен Node.js 20.12 или новее.npm i -g @openemail/cliустанавливает её, аnpx @openemail/cli <command>запускает без установки. - Войти можно двумя способами.
openemail loginоткрывает ваш браузер, где вы выбираете рабочее пространство, разрешения и срок доступа, и каждый вход через браузер становится подключённым приложением, которое можно удалить в разделе «Аккаунт → Подключённые приложения». API-ключ, сохранённый черезopenemail login --with-tokenили заданный вOPENEMAIL_API_KEY, никогда не открывает браузер и никогда не просит код, поэтому подходит для скриптов и CI. - Вход через браузер действует от вашего имени, поэтому чувствительное изменение, например добавление вебхука или удаление домена, требует того же кода подтверждения, что и веб-приложение. Один код действует для этого входа 60 минут, а
openemail verifyзапрашивает его до запуска скрипта. inbox,search,read,replyиsendработают с ящиком так же, как приложение, с тем же синтаксисом поиска, вложениями, отложенной отправкой, отменой и переводом.archive,star,snoozeи другие действия с переписками принимают сразу несколько идентификаторов переписок.- Каждый метод SDK является командой,
openemail <resource> <verb>, поэтому всё, что умеет REST API, умеет и командная строка.openemail apiвызывает любой путь напрямую, с тем же входом. ai translate,ai composeиai summarizeпереносят функции ИИ в терминал.openemail mcp configвыводит настройку для Claude Code, Claude Desktop, Cursor, VS Code, Windsurf и Codex, аopenemail mcp serveпозволяет такому клиенту использовать вход командной строки.- Она сделана для скриптов: данные идут в stdout, всё остальное в stderr,
--jsonвыводит только JSON,--allпроходит все страницы списка, у каждого вида сбоя свой код выхода, и в CI или без терминала ничего не спрашивается.openemail tempсоздаёт одноразовый ящик без аккаунта и без ключа, аtemp watch --firstждёт его первое письмо. - Чего нет: оплате, созданию и переключению рабочих пространств, безопасности аккаунта, экспорту данных, записи событий в календарь, пересылке и подключению DNS-провайдера нужна сессия браузера, поэтому командная строка пока их не делает, а
openemail openвместо этого открывает нужную страницу веб-приложения. Как и у SDK, у неё нет процесса выпуска, поэтому версия попадает в npm, когда кто-то её публикует.
