Назад в блог

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

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

Первая версия CLI Pocket Alert умела отправлять заголовок и сообщение. Этого хватало, чтобы проверить идею, но не больше: не было уровней приоритета, кнопок, отложенной отправки и ничего для самой частой задачи — сообщить, когда длинная команда завершилась.

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

Входящие Pocket Alert CLI в терминале

Установка

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 или URL https://. На платных тарифах.
  • Получатели. -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.

Поделиться статьёй