使用说明

多个 Agent、项目与服务器,如何统一接收通知

把 Claude Code、Codex、CLI 和服务器提醒送到一部手机。用 Source 独立授权,用 Topic 组织工作流,不按 Agent 数量收费。

更新于

一眼看清哪个项目在等你

#

一个仓库构建结束,另一个 Agent 等待确认,服务器备份却报错了。给来源取清楚的名称,在标题和简短正文里说明项目与需要关注的事情。提醒应提供足够的上下文,不必复制整段终端记录。Ntfyx 在同一个收件箱处理普通通知与单次问题。

连接前的准备

#

电脑或服务器需要 Ntfyx CLI 0.1.2,手机需要可用的主手机 App。iPhone 版本正在等待 App Store 审核;Android 1.0.0 已提交 Google Play 生产审核,目前只向已配置的内部测试者开放。这些状态不表示已公开上架。Android 推送需要 Google Play 服务。手机独立授权每台电脑或服务器;Web 收件箱是可选接收端,只能接收授权后发给它的新消息。

Terminal
curl -fsSL https://ntfyx.me/install.sh | bash
ntfyx connect
ntfyx topics

从一个免费 Topic 开始

#

免费版包含一个活跃 Topic,可以接多个已授权 Source。每个电脑、Agent 或仓库不必单独购买 Topic。Source 是使用独立密钥的发送身份。Plus 把活跃 Topic 上限提高到二十个,不叠加消息额度,也不提供无限流量。

Terminal
ntfyx topics
ntfyx send "官网构建通过" --title "官网" --topic Work
ntfyx send "备份失败:请查看服务器日志" --title "备份" --topic Work

每台机器独立连接和撤销

#

在可信电脑或服务器分别运行 connect,由手机授权。服务器只获得它自己的发送身份,不获得手机管理根。不要把桌面凭据复制到所有机器。Agent 名与项目标签用于展示;需要单独撤销的 Agent,应建立独立 Source 身份。

Terminal
ntfyx connect
ntfyx sources

需要时再分工作流

#

构建、客户项目和服务器运维需要独立路由时,可以使用命名 Topic。新建或激活第二个 Topic 需要 Plus。CLI 本地别名用于选择连接,添加别名不等于自动创建服务器 Topic。下面的 Work 应替换成 topics 中实际存在的连接别名。

Terminal
ntfyx send "可以检查结果了" --topic Work
ntfyx ask "检查哪个环境?" \
  --choice staging=预发布 --choice production=生产 --topic Work --json

减少噪声,保留真正的问题

#

普通状态用 send,确实需要你决策或补充信息时才用 ask。每日静音只暂停推送提醒,消息同步和回复仍可用;有效期很短的问题可能在静音时过期,应按工作流设置时长。多个设备同时回答时,中继仲裁一个已接受答案,发送端验证后才能继续。

目前是个人收件箱

#

首版支持一个活跃主手机与最多两个已授权浏览器,没有团队值班表、升级通知、多人的审批策略。原生权限适配只覆盖文档列出的工具、宿主版本和平台。其他工作流可以显式调用 ask 或本地 MCP 提问。