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

> CLI Pocket Alert переписан и открыт по лицензии с открытым исходным кодом. Отправляйте push-уведомления с уровнями, кнопками, изображениями и расписанием, оборачивайте любую команду в exec, превращайте строки логов в push-уведомления с помощью watch и просматривайте всё в полноэкранном терминальном интерфейсе.

*17.10.2026*

<!-- source: https://pocketalert.app/ru/blog/pocketalert-cli-2 -->

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

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

![Входящие Pocket Alert CLI в терминале](https://cdn.pocketalert.app/blog/pocketalert-cli-2-inbox.jpg)

## Установка

**macOS и Linux:**

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

**Homebrew:**

```bash
brew install pocketalert/tap/pocketalert
```

**Go:**

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

**Windows:** скачайте [pocketalert_windows_amd64.zip](https://github.com/PocketAlert/cli/releases/latest/download/pocketalert_windows_amd64.zip) из последнего релиза и положите `pocketalert.exe` в PATH. Каждый релиз включает архивы для macOS и Linux на Intel и ARM и для Windows на x64, с контрольными суммами.

Затем войдите один раз с помощью API-ключа из раздела [API Keys](/account/apikeys):

```bash
pocketalert auth
```

Ключ вводится в скрытом поле, проверяется через API и сохраняется в `~/.pocketalert/config.json` с правами `600`. В CI задайте вместо этого `POCKETALERT_API_KEY`: эта переменная имеет приоритет над сохранённым ключом.

## Отправка со всеми возможностями API

Базовая форма теперь состоит из двух аргументов:

```bash
pocketalert send "Deploy finished" "v1.4.2 is live"
```

Сообщение можно передать через stdin, так что вывод команды сразу попадает на телефон:

```bash
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.

Пример уведомления о неудачном деплое со всеми опциями сразу:

```bash
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-уведомление по завершении:

```bash
pocketalert exec -- ./backup.sh
```

Заголовок push-уведомления — это команда с ✓, либо ✗ и код выхода. В тексте указаны длительность, имя хоста и последние десять строк вывода. Ошибки отправляются с уровнем `high`, если вы не задали уровень явно, а код выхода команды передаётся дальше, поэтому `exec` безопасно использовать в скриптах, cron и CI.

```bash
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` читает строки из пайпа и отправляет их как уведомления:

```bash
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`. Новые сообщения появляются сами, пока приложение открыто.

![Сообщение с кнопками действий в панели предпросмотра](https://cdn.pocketalert.app/blog/pocketalert-cli-2-actions.jpg)

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

![Создание нового сообщения в терминале](https://cdn.pocketalert.app/blog/pocketalert-cli-2-compose.jpg)

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

![Приложения в терминальном интерфейсе](https://cdn.pocketalert.app/blog/pocketalert-cli-2-applications.jpg)

Любое деструктивное действие сначала запрашивает подтверждение, а `?` показывает все горячие клавиши.

## Управление аккаунтом из скриптов

Остальная часть API тоже покрыта, и каждая команда поддерживает `--json`:

```bash
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](/blog/claude-code-push-notifications), [Codex](/blog/codex-notifications) и [Cline и Aider](/blog/cline-aider-notifications) могут вызывать `pocketalert send` вместо curl. Для cron и CI `exec` заменяет большинство однострочников с `|| curl`.

[Установите CLI](/tools/cli), выполните `pocketalert auth` и попробуйте `pocketalert ui`.
