Pocket Alert CLI 2.1: уровни, exec, watch и входящие в терминале

Первая версия CLI Pocket Alert умела отправлять заголовок и сообщение. Этого хватало, чтобы проверить идею, но не больше: не было уровней приоритета, кнопок, отложенной отправки и ничего для самой частой задачи — сообщить, когда длинная команда завершилась.
Версия 2 — это переписанный с нуля CLI. Он живёт в собственном репозитории под лицензией MIT, устанавливается одной командой и покрывает всё, что умеет API. Версия 2.1, которая выходит сегодня, добавляет pocketalert ui: полноэкранное терминальное приложение для входящих, отложенных сообщений, приложений, устройств и вебхуков.

Установка
macOS и Linux:
curl -fsSL https://raw.githubusercontent.com/PocketAlert/cli/main/install.sh | sh
Homebrew:
brew install pocketalert/tap/pocketalert
Go:
go install github.com/PocketAlert/cli/cmd/pocketalert@latest
Windows: скачайте pocketalert_windows_amd64.zip из последнего релиза и положите pocketalert.exe в PATH. Каждый релиз включает архивы для macOS и Linux на Intel и ARM и для Windows на x64, с контрольными суммами.
Затем войдите один раз с помощью API-ключа из раздела API Keys:
pocketalert auth
Ключ вводится в скрытом поле, проверяется через API и сохраняется в ~/.pocketalert/config.json с правами 600. В CI задайте вместо этого POCKETALERT_API_KEY: эта переменная имеет приоритет над сохранённым ключом.
Отправка со всеми возможностями API
Базовая форма теперь состоит из двух аргументов:
pocketalert send "Deploy finished" "v1.4.2 is live"
Сообщение можно передать через stdin, так что вывод команды сразу попадает на телефон:
df -h | pocketalert send "Disk report"
Всё остальное задаётся флагами:
- Уровни.
-l silent|low|default|high|criticalили-2...2.criticalпроходит режим «Не беспокоить» на платных тарифах; на бесплатных тарифах он приходит какhigh. - Расписание.
--at "2026-10-20 09:50"во временной зоне вашего аккаунта или--in 1d12h. До 30 дней вперёд, на платных тарифах. Командыpocketalert scheduled listиscheduled cancel <tid>управляют очередью. - Кнопки действий. До трёх
--action type:label:value, где тип —view,httpилиcopy. На платных тарифах. - Изображения.
--image ./screenshot.pngили URLhttps://. На платных тарифах. - Получатели.
-aдля приложения,-dдля одного устройства. - Скрипты.
-qвыводит только ID сообщения, а каждая команда поддерживает--jsonдля необработанного ответа API.
Пример уведомления о неудачном деплое со всеми опциями сразу:
pocketalert send "Deploy failed" "main@4f2c" -l critical \
--action "view:Open logs:https://ci.example.com/run/1" \
--action "http:Retry:https://ci.example.com/run/1/retry" \
--action "copy:Copy SHA:4f2c9e1"
Кнопка http по умолчанию отправляет POST. Напишите http:Ack:GET https://…, чтобы использовать другой метод, или передайте полную JSON-форму с заголовками и телом запроса.
exec: push-уведомление по завершении команды
То, ради чего большинство людей писали скрипт-обёртку, теперь встроено. exec запускает команду, выводит её результат как обычно и отправляет push-уведомление по завершении:
pocketalert exec -- ./backup.sh
Заголовок push-уведомления — это команда с ✓, либо ✗ и код выхода. В тексте указаны длительность, имя хоста и последние десять строк вывода. Ошибки отправляются с уровнем high, если вы не задали уровень явно, а код выхода команды передаётся дальше, поэтому exec безопасно использовать в скриптах, cron и CI.
pocketalert exec --on failure -l critical -- terraform apply -auto-approve
pocketalert exec -t "Nightly import" --tail 20 -- python import.py
--on определяет, когда отправлять уведомление: always, success или failure. --tail задаёт, сколько строк вывода включать, или 0, чтобы не включать ни одной.
watch: строки логов как push-уведомления
watch читает строки из пайпа и отправляет их как уведомления:
tail -f app.log | grep --line-buffered ERROR | pocketalert watch -t "app errors"
journalctl -fu nginx | pocketalert watch --batch 1m -l high
Строки, пришедшие в пределах окна пакета (по умолчанию пять секунд), объединяются в одно push-уведомление с количеством строк в заголовке. Всплеск из двухсот ошибок расходует одно сообщение из дневного лимита, а не двести.
pocketalert ui
Запустите pocketalert ui, и терминал превратится в клиент Pocket Alert. Пять вкладок переключаются клавишей tab или клавишами от 1 до 5: Inbox (входящие), Scheduled (отложенные), Applications (приложения), Devices (устройства) и Webhooks (вебхуки).
На вкладке Inbox показаны сообщения с уровнем, приложением и временем; непрочитанные отмечены точкой. Панель справа выводит выбранное сообщение целиком, включая кнопки действий и их адреса. Поиск — клавишей /, показать только непрочитанные — u, отметить одно сообщение прочитанным — r, все — a. Новые сообщения появляются сами, пока приложение открыто.

Клавиша n открывает редактор: заголовок и текст, затем приложение, устройство, уровень, время доставки, изображение и до трёх кнопок действий в том же формате type:label:value, что и флаги send. ctrl+s отправляет. Клавиша f на существующем сообщении снова открывает его в редакторе — чтобы отправить повторно или использовать как шаблон.

Остальные вкладки управляют остальной частью аккаунта. Applications показывает каждое приложение с уровнем по умолчанию: создавайте, переименовывайте, меняйте уровень или удаляйте, не покидая клавиатуры, а enter открывает сообщения этого приложения. Devices показывает ваши телефоны и позволяет переименовать или удалить их. Webhooks показывает вебхуки с историей запросов, а y копирует URL вебхука. Scheduled показывает очередь и отменяет сообщения клавишей d.

Любое деструктивное действие сначала запрашивает подтверждение, а ? показывает все горячие клавиши.
Управление аккаунтом из скриптов
Остальная часть API тоже покрыта, и каждая команда поддерживает --json:
pocketalert usage # today's quota
pocketalert messages list -n 20
pocketalert messages read --all
pocketalert apps create -n "Production" -c "#EF4444" -l high
pocketalert webhooks create -n Grafana -m "%title%: %message%" -l high
pocketalert webhooks history <tid> --status error
pocketalert devices rename <tid> "Work phone"
Из CLI теперь можно задавать уровень по умолчанию для приложений и вебхуков, а также кнопки действий для вебхуков с плейсхолдерами %field.path%, которые заполняются из payload. Так оповещение Grafana может прийти с уровнем high и кнопкой, которая открывает именно эту панель.
Автодополнение для zsh, bash и fish доступно через pocketalert completion.
Обновление с версии 1.x
Установите 2.1любым из способов выше: новая версия заменит старый бинарный файл и сохранит ваш ключ. Три изменения могут повлиять на существующие скрипты:
- Сообщение теперь обязательно.
pocketalert send -t "Cron OK"без-mвозвращает ошибку. Добавьте сообщение, передайте его через пайп или используйтеexec, который сформирует его сам. - Не смешивайте формы. Используйте либо
send "Title" "Message", либоsend -t "Title" -m "Message". Записьsend -t "Title" "Message"воспринимает второй аргумент как заголовок и на этом останавливается. - Для сгенерированного текста используйте
-m. Позиционное сообщение, которое начинается с дефиса, например Markdown-список от ИИ-агента, принимается за опцию.-m "$text"всегда безопасен.
Архивы релизов теперь называются pocketalert_<os>_<arch>.tar.gz, а в Windows — .zip, если вы скачиваете их в скрипте развёртывания.
По пути исправлено несколько ошибок из версии 1.x: webhooks create теперь учитывает --application и --device, URL вебхуков ведут на правильный хост, ошибки выводятся в stderr, а не в stdout, заголовки на нелатинице больше не обрезаются посреди символа, а при достижении дневного лимита показываются ваше использование и время сброса вместо голого 429.
Где это пригодится
CLI теперь — самый короткий путь от терминала до телефона, а руководства этого блога используют его там, где это экономит строки. Для ИИ-агентов скрипты хуков из руководств по Claude Code, Codex и Cline и Aider могут вызывать pocketalert send вместо curl. Для cron и CI exec заменяет большинство однострочников с || curl.
Установите CLI, выполните pocketalert auth и попробуйте pocketalert ui.