Установка
npm, pnpm, Bun или Yarn, или вообще без установки через npx.
Установка
Текущий выпуск: 0.0.1. Ему нужен Node.js 20.12 или новее.
npm install -g @openemail/cliПакет это один собранный файл без зависимостей, и он добавляет в ваш PATH одну команду: openemail. SDK, которым он вызывает API, встроен, поэтому CLI всегда работает с тем SDK, с которым её тестировали. openemail version выводит версии обоих и среды выполнения.
openemail --versionopenemail --helpЗапуск без установки
npx скачивает пакет в кэш и запускает его, что удобно для разовой команды, задачи CI или MCP-клиента, который запускает локальный мост.
npx @openemail/cli --helpnpx -y @openemail/[email protected] whoaminpx -y @openemail/cli mcp serveЗакрепите версию в CI, как в npx -y @openemail/[email protected], чтобы новый выпуск никогда незаметно не менял конвейер.
Обновления
CLI никогда не обновляется сама. Она сутки помнит, что реестр npm сказал о последнем выпуске. Когда эти сведения старше, она спрашивает снова в фоне, пока работает ваша команда, а после её завершения ждёт ответа не дольше пятой доли секунды. Если есть более новый выпуск, она выводит уведомление в stderr после завершения вашей команды:
Update available! 0.0.1 → 0.0.2Changelog: https://openemail.uk/docs/cli/changelogRun `npm i -g @openemail/cli@latest` to update. Disable this notice with OPENEMAIL_NO_UPDATE_CHECK=1- Команда установки в уведомлении соответствует менеджеру пакетов, которым вы устанавливали.
- Уведомления нет с
--help,--versionили--json, дляhelp,version,updateиcompletion, когда stdout или stderr не терминал, и в CI. - Задайте
OPENEMAIL_NO_UPDATE_CHECK=1, чтобы отключить его везде.OPENEMAIL_DISABLE_UPDATE_NOTICE=1делает то же самое. - Единственный запрос уходит в реестр npm, а его ответ хранится в
~/.openemail/update-check.jsonодин день.
openemail update проверяет сразу, без суточного кэша, и выводит либо команду для запуска, либо что у вас последняя версия.
npm i -g @openemail/cli@latestАвтодополнение в оболочке
openemail completion <shell> выводит скрипт автодополнения для bash, zsh или fish, построенный из каждой команды, подкоманды и флага вашей версии. Запустите его снова после обновления.
echo 'eval "$(openemail completion bash)"' >> ~/.bashrcУдаление
Сначала выйдите, чтобы каждый вход через браузер был отозван на сервере, затем удалите пакет и папку, в которой CLI хранит входы.
openemail logout --allnpm uninstall -g @openemail/clirm -rf ~/.openemail
