Командная строка

Push-уведомления прямо из терминала.

Отправляйте уведомления из скриптов, cron-задач и CI/CD или просматривайте входящие в полноэкранном терминальном интерфейсе. Один статический бинарник, никаких зависимостей.

Push-уведомление через <1sОдин бинарник · без зависимостейLinux · macOS · WindowsОткрытый код · MIT
# Fire a notification from anywhere
pocketalert send "Deploy finished" "v2.4.0 is live 🚀"
✓ Sent

# Critical alert with buttons — gets through Do Not Disturb
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"
✓ отправлено · уровни · кнопки · изображения · отложенная отправка
Возможности

Весь API — одной командой

Всё, что умеет Pocket Alert, встроено в инструменты, с которыми вы уже работаете: консоль, скрипты, пайплайны.

Интерактивный режим

Запустите pocketalert ui и получите полноэкранные входящие: поиск, чтение, создание сообщений с уровнями и кнопками, управление приложениями, устройствами и вебхуками.

Создан для скриптов

Добавляйте уведомления в любой скрипт, Makefile или однострочник. Без браузера и панели — только консоль.

Кроссплатформенность

Один статический бинарник для Linux, macOS (Intel и Apple Silicon) и Windows. Без рантайма и зависимостей.

Для CI/CD

Подключайте уведомления к GitHub Actions, GitLab CI, Jenkins или любому пайплайну. Один раз авторизуйтесь — и отправляйте откуда угодно.

Полный доступ к API

Уровни приоритета вплоть до critical, кнопки действий, изображения и отложенная отправка через --at или --in.

Узнавайте о завершении задач

Запустите любую команду через pocketalert exec и получите push с кодом возврата, временем выполнения и последними строками вывода.

Безопасность по умолчанию

API-ключ вводится в скрытом поле, хранится с правами 600 или передаётся через POCKETALERT_API_KEY в CI.

Доставка менее чем за секунду

Push приходит на телефон меньше чем за секунду. Идеально для скриптов мониторинга, деплоев и системных уведомлений.

Интерактивный режим

Ваши входящие — в терминале

Запустите pocketalert ui, чтобы искать и читать сообщения, создавать новые с уровнями, расписанием и кнопками действий, управлять приложениями, устройствами и вебхуками — не отрываясь от клавиатуры.

pocketalert ui
Интерактивный режим Pocket Alert CLI: входящие с предпросмотром сообщения
Начало работы

Три шага до первого push-уведомления

1

Установите CLI

Запустите установщик одной командой, воспользуйтесь Homebrew или скачайте бинарник для своей платформы ниже.

2

Авторизуйтесь

Один раз выполните pocketalert auth и вставьте API-ключ. В CI вместо этого задайте POCKETALERT_API_KEY.

3

Отправьте первое push-уведомление

Выполните pocketalert send "Title" "Message" — через мгновение телефон завибрирует.

Скачать

Скачайте бинарник

Выберите платформу и архитектуру — готовая сборка, которую остаётся положить в PATH.

macOS

.tar.gz

Linux

.tar.gz

Windows

.zip

Все релизы, контрольные суммы и исходный код — на GitHub.

Установка

Linux / macOS

curl -fsSL https://raw.githubusercontent.com/PocketAlert/cli/main/install.sh | sh

Или через Homebrew:

brew install pocketalert/tap/pocketalert

Скрипт проверяет контрольную сумму SHA-256. Чтобы зафиксировать версию, задайте POCKETALERT_VERSION=v2.1.0.

Windows

Распакуйте архив и добавьте папку с pocketalert.exe в переменную окружения PATH.

Go

go install github.com/PocketAlert/cli/cmd/pocketalert@latest

Затем проверьте работу командой pocketalert version.

Быстрый старт

1. Авторизация

pocketalert auth

Получите API-ключ на странице API-ключей. Он безопасно хранится в ~/.pocketalert/config.json.

2. Отправка уведомления

pocketalert send "Hello" "It works 🎉"

В CI и контейнерах пропустите auth и задайте POCKETALERT_API_KEY.

Примеры

Уровни, кнопки и изображения

pocketalert send "Disk 95%" "/var is almost full" --level high
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"
pocketalert send "Grafana" "CPU spike" --image ./panel.png

Уровни — от silent до critical. Типы кнопок: view (открыть URL), http (вызвать вебхук) и copy, до трёх на сообщение.

Передача сообщения через pipe

df -h | pocketalert send "Disk report"
pocketalert send -t "AI summary" -m "$SUMMARY"      # safe for text that starts with "-"

Отложенная отправка

pocketalert send "Standup" "In 10 minutes" --at "2026-10-20 09:50"
pocketalert send "Reminder" "Rotate the keys" --in 1d12h
pocketalert scheduled list
pocketalert scheduled cancel <tid>

Уведомление о завершении команды

pocketalert exec -- make release
pocketalert exec --on failure -l critical -- ./backup.sh
pocketalert exec -t "Nightly import" --tail 20 -- python import.py

Вы получите push с ✓ или ✗, временем выполнения и последними строками вывода. Код возврата сохраняется, поэтому exec безопасно использовать в CI и скриптах с set -e.

Слежение за логом

tail -f app.log | grep --line-buffered ERROR | pocketalert watch -t "app errors"
journalctl -fu nginx | pocketalert watch --batch 1m -l high

Строки, поступившие в пределах --batch (по умолчанию 5 с), объединяются в один push, так что серия ошибок расходует только одно сообщение дневного лимита.

Скрипты

TID=$(pocketalert send "Build" "started" -q)       # print only the TID
pocketalert messages list --json | jq -r '.data[].title'
pocketalert usage                                   # today's quota

Каждая команда поддерживает --json, ошибки выводятся в stderr, а коды возврата надёжны. Критические уведомления, кнопки, изображения и отложенная отправка требуют платного тарифа; на бесплатном тарифе сообщение всё равно доставляется, а CLI сообщит, что было отброшено.

Все команды и флаги — сообщения, приложения, устройства, вебхуки, формы и API-ключи — смотрите в полной документации CLI.

FAQ

Ответы на вопросы

Pocket Alert CLI — утилита командной строки с открытым кодом, которая отправляет push-уведомления на телефон из скриптов, cron-задач и CI. Она может запустить команду и сообщить о её завершении, превратить строки лога в уведомления и управлять сообщениями, приложениями, устройствами, вебхуками, формами и API-ключами без браузера.

Да. pocketalert ui открывает полноэкранное приложение в терминале: просмотр и поиск по входящим, чтение сообщений с кнопками действий, создание новых с уровнем, расписанием, изображением и кнопками, управление отложенными сообщениями, приложениями, устройствами и вебхуками. Новые сообщения появляются сами; нажмите ?, чтобы увидеть все сочетания клавиш.

После установки CLI выполните pocketalert auth и вставьте API-ключ в запросе. Создайте API-ключ на странице API-ключей. CLI проверит ключ и сохранит его в ~/.pocketalert/config.json. В CI вместо этого задайте POCKETALERT_API_KEY.

Pocket Alert CLI выпускается для Linux (AMD64 и ARM64), macOS (Intel и Apple Silicon) и Windows (AMD64). Готовые бинарники доступны для всех поддерживаемых платформ.

Выполните pocketalert send "Title" "Message". Добавьте --level critical, до трёх кнопок --action, --image или запланируйте отправку через --at / --in.

Конечно — CLI создан и для CI/CD. Задайте POCKETALERT_API_KEY как секрет и вызывайте pocketalert send или оберните шаг в pocketalert exec -- make deploy, чтобы получить результат на телефон.

Нет. Отправка, exec, watch и интерактивный режим работают на бесплатном тарифе. Критический уровень, кнопки действий, изображения и отложенная отправка требуют платного тарифа; на бесплатном тарифе сообщение всё равно доставляется, а CLI сообщит, что было отброшено.

Да. CLI хранит API-ключ в ~/.pocketalert/config.json с правами 600 в каталоге конфигурации с правами 700. Весь трафик идёт по HTTPS, а ключ передаётся в заголовке Token.

В вашем терминале появился канал уведомлений

Скачайте бинарник, один раз авторизуйтесь и отправьте первое push-уведомление из терминала меньше чем за минуту.