CLI
Журнал изменений
Каждый выпуск CLI, новые сверху.
0.0.1
Первый выпуск: весь OpenEmail из терминала, с входом через браузер для людей и API-ключами для скриптов.
- Вход:
openemail loginв браузере, который сам возвращается в терминал на настольном компьютере, а через SSH или с--no-browserчерез вставленный код. API-ключи через--token,--with-token,OPENEMAIL_API_KEYили--api-key. Профили черезprofile list,use,currentиremove. - Токены доступа, которые обновляются до истечения, по одному обновлению за раз на профиль, и одноразовые токены обновления: старый, использованный больше чем через 30 секунд после замены, заставляет сервер отозвать этот вход.
- Сохранённый вход уходит только в тот API, в который он вошёл. Обычный
httpотклоняется, кромеlocalhost,127.0.0.1и::1, а путь запроса, который вышел бы за пределы адреса API, останавливается сinvalid_path. - Коды подтверждения перед чувствительными изменениями при входе через браузер: запрашиваются, когда они нужны команде, или заранее через
openemail verify. Они действуют для REST API и для MCP-инструментов, которые вносят те же изменения. - Каждый вход может запросить 5 кодов в час и 20 в день. Десять неверных кодов за 24 часа ставят его подтверждение на паузу, а CLI сообщает, когда оно возобновится, и завершается с кодом выхода
4иstep_up_paused. whoami,statusиlogout, который отзывает вход через браузер на сервере.- Отправка через
send: текст, HTML, файл, stdin или ваш редактор, вложения любого размера, планирование, окно отмены, перевод, шаблоны и теги. - Почтовый ящик:
inbox,search,readиreply, а такжеarchive,unarchive,trash,star,unstar,mark,snooze,unsnoozeиlabel. - Одноразовые ящики через
temp new,list,read,watchиdelete, без входа. - Команда ресурса для каждого метода SDK: 282 метода как 198 команд в 26 пространствах имён, причём
securityнет в справке, потому что его покрываетopenemail verify. Типизированные флаги,--dataиз JSON, файла или stdin, постраничная выборка через--all,--maxи--ndjson, загрузки через--outи подтверждение перед всем разрушительным. - ИИ:
ai translate,ai languages,ai composeиai summarize. - MCP:
mcp configдля Claude Code, Claude Desktop, Cursor, VS Code, Windsurf и Codex,mcp serveкак локальный stdio-мост, а такжеmcp toolsиmcp call, которая запрашивает код подтверждения и снова вызывает инструмент, когда он нужен. docs ask,docs openиdocs read,openдля страниц веб-приложения иapiдля любого вызова REST.- Скрипты:
--jsonс оболочкой ошибки в stderr, потоки NDJSON, стабильные коды выхода,--no-inputи распознавание CI. - Справка по каждой команде и группе, подсказки при опечатках в командах и флагах и автодополнение для bash, zsh и fish.
- Входы и токены ящиков в
~/.openemail, доступные для чтения только вам и изменяемые под файлом блокировки, а повреждённыйconfig.jsonсохраняется какconfig.json.bak, а не читается как выход. - Текст с сервера очищается, прежде чем попасть в терминал, а вывод, переданный медленному читателю, записывается полностью до завершения CLI.
- Ежедневное уведомление об обновлении, которое отключает
OPENEMAIL_NO_UPDATE_CHECK=1, иopenemail update. - Один собранный файл без зависимостей, на Node.js 20.12 или новее.
Не в этом выпуске: оплата, рабочие пространства, безопасность аккаунта, экспорт данных, изменения в календаре, пересылка, подключение DNS-провайдера и чат ассистента пока остаются в веб-приложении, и openemail open открывает каждое из них.
npm install -g @openemail/cliopenemail loginopenemail inbox