# 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,一条命令即可调用
Pocket Alert 的全部功能,都能接入你日常使用的工具:shell、脚本和流水线。
交互模式
运行 pocketalert ui 打开全屏收件箱:搜索、阅读、撰写带级别和按钮的消息,并管理应用、设备和 Webhook。
为脚本而生
可在任何脚本、Makefile 或单行命令中发送通知。无需浏览器和控制台,只用 shell。
跨平台
单个静态二进制文件,支持 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 传入。
亚秒级送达
推送在一秒内到达你的手机,非常适合监控脚本、部署和系统告警。
你的收件箱,就在终端里
运行 pocketalert ui 即可搜索和阅读消息,撰写带级别、定时和操作按钮的新消息,并管理应用、设备和 Webhook,全程无需离开键盘。

三步发出第一条推送
安装 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 | 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,每条消息最多三个。
通过管道传入消息
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你会收到一条带有 ✓ 或 ✗、耗时和最后几行输出的推送。退出码会被透传,因此 exec 可以放心用于 CI 和 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 秒)内到达的行会合并为一条推送,所以一连串错误只会消耗每日额度中的一条消息。
脚本化
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、最多三个 --action 按钮、--image 图片,或用 --at / --in 定时发送。
当然可以,CLI 就是为 CI/CD 打造的。将 POCKETALERT_API_KEY 设为密钥并调用 pocketalert send,或用 pocketalert exec -- make deploy 包装某个步骤,在手机上收到它的结果。
不需要。发送、exec、watch 和交互模式在免费套餐下均可使用。critical 级别、操作按钮、图片和定时发送需要付费套餐;在免费套餐下消息仍会送达,CLI 会告诉你哪些内容被省略。
安全。CLI 会将你的 API 密钥存储在 ~/.pocketalert/config.json 中,文件权限为 600,所在配置目录权限为 700。所有流量均通过 HTTPS 传输,密钥放在 Token 请求头中发送。