コマンドラインインターフェース

プッシュ通知を、ターミナルから。

スクリプト、cron ジョブ、CI/CD からアラートを送信できます。フルスクリーンのターミナル UI で受信箱の確認も可能。単一の静的バイナリで、依存関係はありません。

<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 のすべてを、1 つのコマンドで

Pocket Alert の機能をすべて、いつものシェル、スクリプト、パイプラインから使えます。

対話モード

pocketalert ui を実行すると、フルスクリーンの受信箱が開きます。検索や閲覧、レベルやボタン付きの作成、アプリケーション、デバイス、Webhook の管理ができます。

スクリプトに組み込みやすい設計

スクリプト、Makefile、ワンライナーなど、どこにでも通知を組み込めます。ブラウザもダッシュボードも不要で、シェルだけで完結します。

クロスプラットフォーム

Linux、macOS(Intel / Apple Silicon)、Windows に対応した単一の静的バイナリ。ランタイムも依存関係も不要です。

CI/CD 向けに設計

GitHub Actions、GitLab CI、Jenkins などあらゆるパイプラインにアラートを組み込めます。認証は一度だけで、どこからでも送信できます。

API をフルに利用可能

critical までの優先度レベル、アクションボタン、画像添付、--at や --in による予約送信に対応しています。

ジョブの完了をすぐ把握

任意のコマンドを pocketalert exec でラップすると、終了コード、実行時間、出力の最終行がプッシュ通知で届きます。

デフォルトで安全

API キーは非表示のプロンプトで入力し、パーミッション 600 で保存されます。CI では POCKETALERT_API_KEY で渡せます。

1 秒未満で配信

プッシュ通知は 1 秒以内にスマホへ届きます。監視スクリプト、デプロイ、システムアラートに最適です。

対話モード

受信箱を、ターミナルで

pocketalert ui を実行すると、メッセージの検索や閲覧、レベル・予約送信・アクションボタン付きの新規作成、アプリケーション、デバイス、Webhook の管理を、キーボードだけで行えます。

pocketalert ui
Pocket Alert CLI の対話モード:メッセージのプレビュー付き受信箱
はじめる

3 ステップで最初のプッシュ通知を送信

1

CLI をインストール

ワンライナーのインストーラーか Homebrew を使うか、下からお使いのプラットフォーム用バイナリをダウンロードしてください。

2

認証

pocketalert auth を一度実行し、API キーを貼り付けます。CI では代わりに POCKETALERT_API_KEY を設定してください。

3

最初のプッシュ通知を送信

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(Webhook を呼び出す)、copy で、1 メッセージにつき最大 3 つまで設定できます。

パイプでメッセージを渡す

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

✓ か ✗、実行時間、出力の最終行がプッシュ通知で届きます。終了コードはそのまま返されるので、CI や exec のスクリプトでも安心して 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 秒)以内に届いた行は 1 件のプッシュ通知にまとめられるため、エラーが連続しても 1 日の上限の消費は 1 通で済みます。

スクリプトでの利用

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 に出力され、終了コードも信頼できます。critical のアラート、ボタン、画像、予約送信は有料プランが必要です。無料プランでもメッセージは配信され、省略された内容は CLI が知らせます。

メッセージ、アプリケーション、デバイス、Webhook、フォーム、API キーなど、すべてのコマンドとフラグについては CLI ドキュメントをご覧ください。

よくある質問

よくある質問と回答

Pocket Alert CLI は、スクリプト、cron ジョブ、CI からスマホにプッシュ通知を送れるオープンソースのコマンドラインツールです。コマンドをラップして完了を通知したり、ログの行をアラートに変えたりできるほか、メッセージ、アプリケーション、デバイス、Webhook、フォーム、API キーの管理もブラウザなしで行えます。

はい。pocketalert ui を実行すると、ターミナルでフルスクリーンのアプリが開きます。受信箱の閲覧と検索、アクションボタン付きメッセージの確認、レベル・予約・画像・ボタンを指定した新規作成、予約送信メッセージ、アプリケーション、デバイス、Webhook の管理ができます。新着メッセージは自動で表示されます。? を押すとショートカット一覧を確認できます。

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、最大 3 つの --action ボタン、--image を追加したり、--at / --in で予約送信したりもできます。

もちろんです。CLI は CI/CD 向けに作られています。POCKETALERT_API_KEY をシークレットとして設定して pocketalert send を呼び出すか、pocketalert exec -- make deploy のようにステップをラップすれば、結果がスマホに届きます。

いいえ。送信、exec、watch、対話モードは無料プランで使えます。critical レベル、アクションボタン、画像、予約送信は有料プランが必要です。無料プランでもメッセージは配信され、省略された内容は CLI が知らせます。

はい。CLI は API キーを、700 で作成した設定ディレクトリ内の ~/.pocketalert/config.json にファイルパーミッション 600 で保存します。通信はすべて HTTPS で行われ、キーは Token ヘッダーで送信されます。

ターミナルが、通知チャンネルになります

バイナリをダウンロードして一度認証するだけで、1 分足らずでターミナルから最初のプッシュ通知を送れます。