ブログに戻る

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

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

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

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

続いて、API キー で一度ログインします。

pocketalert auth

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

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

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

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

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

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 の生のレスポンスを得られます。

デプロイが失敗したときの例です。すべての機能をまとめて使っています。

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 はコマンドを実行し、出力はいつもどおり表示したうえで、終了時にプッシュ通知を送ります。

pocketalert exec -- ./backup.sh

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

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

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 ですべてを既読にできます。アプリを開いている間は、新しいメッセージが自動で表示されます。

プレビューペインにアクションボタン付きのメッセージを表示した画面

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

ターミナルで新しいメッセージを作成している画面

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

ターミナル UI でアプリケーションを表示した画面

削除など元に戻せない操作はすべて、実行前に確認が入ります。? を押すと、すべてのショートカットを確認できます。

スクリプトからのアカウント管理

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 から、アプリケーションと 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、Codex、Cline と Aider のガイドにあるフックスクリプトは、curl の代わりに pocketalert send を呼び出せます。cron や CI では、exec を使えば || curl の 1 行スクリプトのほとんどを置き換えられます。

CLI をインストールして、pocketalert auth を実行し、pocketalert ui を試してみてください。

この記事をシェア