# Pocket Alert CLI 2.1：レベル、exec、watch、ターミナルで使える受信箱

> Pocket Alert CLI を書き直し、オープンソースで公開しました。レベル、ボタン、画像、予約送信付きで送信できるほか、exec であらゆるコマンドを包み、watch でログの行をプッシュ通知に変え、全画面のターミナル UI ですべてを確認できます。

*17.10.2026*

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

最初の Pocket Alert CLI でできたのは、タイトルとメッセージの送信だけでした。アイデアを確かめるにはそれで足りましたが、それ以上のことはできませんでした。優先度レベルも、ボタンも、予約送信もなく、最も多い用途である「長いコマンドが終わったら知らせる」にも対応していませんでした。

バージョン 2 は書き直しです。MIT ライセンスの独立したリポジトリに置かれ、コマンド 1 つでインストールでき、API でできることをすべて扱えます。本日公開のバージョン 2.1 では、受信箱、予約送信、アプリケーション、デバイス、Webhook を操作できる全画面のターミナルアプリ `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 の通った場所に置いてください。すべてのリリースには、Intel と ARM の macOS および Linux、x64 の Windows 向けアーカイブがチェックサム付きで含まれます。

続いて、[API キー](/account/apikeys) で一度ログインします。

```bash
pocketalert auth
```

キーは非表示のプロンプトで入力され、API で検証されたうえで、モード `~/.pocketalert/config.json` の `600` に保存されます。CI では代わりに `POCKETALERT_API_KEY` を設定してください。保存済みのキーより優先されます。

## 送信：API のすべての機能を利用可能

基本の形は引数 2 つになりました。

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

メッセージは標準入力から渡せるため、コマンドの出力をそのままスマホに送れます。

```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` を最大 3 つまで指定できます。type には `view`、`http`、`copy` を使います。有料プランで利用できます。
- **画像。** `--image ./screenshot.png` または `https://` の URL。有料プランで利用できます。
- **送信先。** `-a` でアプリケーション、`-d` で 1 台のデバイスを指定します。
- **スクリプト連携。** `-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：コマンド終了時にプッシュ通知

コマンドの終了を知らせるラッパースクリプトを書く人は多いと思いますが、その機能が組み込まれました。`exec` はコマンドを実行し、出力はいつもどおり表示したうえで、終了時にプッシュ通知を送ります。

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

通知のタイトルは、コマンド名の前に ✓ が付きます。失敗した場合は ✗ と終了コードが付きます。本文には実行時間、ホスト名、出力の最後の 10 行が含まれます。レベルを指定しない限り、失敗時は `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：ログの行をプッシュ通知に

`watch` はパイプから行を読み取り、通知として送信します。

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

バッチの時間枠（既定は 5 秒）内に届いた行は、タイトルに行数を添えて 1 件のプッシュ通知にまとめられます。200 件のエラーが一度に出ても、1 日の上限から消費されるのは 200 件ではなく 1 件です。

## pocketalert ui

`pocketalert ui` を実行すると、ターミナルが Pocket Alert のクライアントになります。タブは 5 つあり、`tab` または `1` から `5` で切り替えます。受信箱、予約送信、アプリケーション、デバイス、Webhook です。

**受信箱** には、メッセージのレベル、アプリケーション、時刻が一覧表示されます。未読のメッセージには点が付きます。右側のペインには選択中のメッセージが全文で表示され、アクションボタンとその送信先も確認できます。`/` で検索、`u` で未読のみ表示、`r` で 1 件を既読、`a` ですべてを既読にできます。アプリを開いている間は、新しいメッセージが自動で表示されます。

![プレビューペインにアクションボタン付きのメッセージを表示した画面](https://cdn.pocketalert.app/blog/pocketalert-cli-2-actions.jpg)

`n` を押すと**作成画面**が開きます。タイトルとメッセージを入力したあと、アプリケーション、デバイス、レベル、送信日時、画像、アクションボタン（最大 3 つ）を設定します。ボタンの書式は `type:label:value` のフラグと同じ `send` です。`ctrl+s` で送信します。既存のメッセージで `f` を押すと、作成画面に読み込まれます。再送したり、テンプレートとして使ったりできます。

![ターミナルで新しいメッセージを作成している画面](https://cdn.pocketalert.app/blog/pocketalert-cli-2-compose.jpg)

ほかのタブでは、アカウントのその他の要素を管理できます。**アプリケーション** では各アプリケーションの既定レベルを確認できます。キーボードだけで作成、名前変更、レベル変更、削除ができ、`enter` を押すとそのアプリケーションのメッセージを表示できます。**デバイス** ではスマホの一覧を表示し、名前変更や削除ができます。**Webhook** では各 Webhook とリクエストの履歴を表示でき、`y` で Webhook の URL をコピーできます。**予約送信** では予約中の通知を表示し、`d` で取り消せます。

![ターミナル UI でアプリケーションを表示した画面](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 から、アプリケーションと Webhook の既定レベルを設定できるようになりました。また、Webhook にアクションボタンを設定し、`%field.path%` のプレースホルダーでペイロードの値を埋め込めます。これにより、Grafana のアラートを `high` で届け、そのパネルをちょうど開くボタンを付けることができます。

`pocketalert completion` で zsh、bash、fish の補完スクリプトを出力できます。

## 1.x からのアップグレード

上記のどの方法でも 2.1 をインストールできます。古いバイナリを置き換え、保存済みのキーも引き継がれます。既存のスクリプトに影響する可能性がある変更は 3 つです。

- **メッセージが必須になりました。** `pocketalert send -t "Cron OK"` を指定しないまま `-m` を実行するとエラーになります。メッセージを追加するか、パイプで渡すか、メッセージを自動生成する `exec` を使ってください。
- **2 つの書き方を混ぜないでください。** `send "Title" "Message"` か、`send -t "Title" -m "Message"` のどちらかを使ってください。`send -t "Title" "Message"` では、2 番目の引数がタイトルとして扱われ、そこで処理が止まります。
- **生成されたテキストには `-m` を使ってください。** AI エージェントが出力した Markdown のリストのように、ダッシュで始まる位置引数のメッセージはオプションとして解釈されます。`-m "$text"` と書けば常に安全です。

プロビジョニングのスクリプトでリリースアーカイブをダウンロードする場合、ファイル名は `pocketalert_<os>_<arch>.tar.gz` に変わりました。Windows では `.zip` です。

1.x の不具合もいくつか修正しました。`webhooks create` で `--application` と `--device` が効くようになりました。Webhook の URL が正しいホストを指すようになりました。エラーは標準出力ではなく標準エラー出力に出るようになりました。ラテン文字以外のタイトルが文字の途中で切れなくなりました。1 日の上限に達したときは、素の `429` ではなく、利用状況とリセット時刻が表示されるようになりました。

## 使いどころ

CLI は、ターミナルからスマホまでの最短経路になりました。このブログのガイドでも、行数を減らせる場面では CLI を使っています。コーディングエージェントの場合、[Claude Code](/blog/claude-code-push-notifications)、[Codex](/blog/codex-notifications)、[Cline と Aider](/blog/cline-aider-notifications) のガイドにあるフックスクリプトは、curl の代わりに `pocketalert send` を呼び出せます。cron や CI では、`exec` を使えば `|| curl` の 1 行スクリプトのほとんどを置き換えられます。

[CLI をインストール](/tools/cli)して、`pocketalert auth` を実行し、`pocketalert ui` を試してみてください。
