プッシュ通知を、ターミナルから。
スクリプト、cron ジョブ、CI/CD からアラートを送信できます。フルスクリーンのターミナル UI で受信箱の確認も可能。単一の静的バイナリで、依存関係はありません。
# 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 の管理を、キーボードだけで行えます。

3 ステップで最初のプッシュ通知を送信
CLI をインストール
ワンライナーのインストーラーか Homebrew を使うか、下からお使いのプラットフォーム用バイナリをダウンロードしてください。
認証
pocketalert auth を一度実行し、API キーを貼り付けます。CI では代わりに POCKETALERT_API_KEY を設定してください。
最初のプッシュ通知を送信
pocketalert send "Title" "Message" を実行すると、すぐにスマホが振動します。
バイナリをダウンロード
プラットフォームとアーキテクチャを選んでください。ビルド済みで、PATH に置くだけで使えます。
すべてのリリース、チェックサム、ソースコードは GitHub にあります。
インストール
Linux / macOS
curl -fsSL https://raw.githubusercontent.com/PocketAlert/cli/main/install.sh | shHomebrew を使う場合:
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 authAPI キーは 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 ヘッダーで送信されます。