命令行工具

推送通知,直接从终端发出。

在脚本、cron 任务和 CI/CD 中发送告警,或在全屏终端界面中浏览收件箱。单个静态二进制文件,零依赖。

<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,一条命令即可调用

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,全程无需离开键盘。

pocketalert ui
Pocket Alert CLI 交互模式:带消息预览的收件箱
快速开始

三步发出第一条推送

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,每条消息最多三个。

通过管道传入消息

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 请求头中发送。

你的终端,现在有了通知渠道

下载二进制文件,认证一次,一分钟内就能从终端发出第一条推送。