使用说明
CLI 发通知,Agent 来提问,手机上处理。
Ntfyx(notify x to me)让 CLI、脚本和 Agent 把加密通知与问题发送到你的 iPhone,也可以由手机授权浏览器,在 Web 收件箱处理。
从安装到第一条消息
需要 macOS 或 Linux 电脑与可用的 Ntfyx iPhone 版本。iPhone App 目前正在等待 App Store 审核,尚未宣布公开下载。
- 在电脑安装 CLI,并运行 ntfyx connect,显示连接二维码。
- 在手机创建一个自己命名的 Topic,使用其中的 Connect Topic 扫码并确认来源。
- 电脑运行 ntfyx send 发送通知;需要你回答时,运行 ntfyx ask。
- 在手机查看通知或回复;发送端验证回复签名后,按对应操作的规则继续。
curl -fsSL https://ntfyx.me/install.sh | bash
ntfyx connect
ntfyx send "备份完成"
ntfyx ask "继续执行?" --allow-deny从电脑,到你的口袋
看得见的连接过程。
打开 Ntfyx → 连接 Topic
等待手机扫码…✓ Work · 已连接让工作, 随时联系你。
连接 Topic,接收第一条消息。
对准电脑上的二维码
收件箱
电脑发来的消息会显示在这里。
9 月 29 日 星期二
9:41点一下通知,查看消息 ↑电脑发起连接
运行 ntfyx connect,生成一次性连接二维码。
手机扫码,命名 Topic
用 Ntfyx 扫码,创建 Work 通道,也可选择已有 Topic。
电脑发送消息
一条命令即可发送。CLI 或 Agent 在本地加密消息。
手机收到,就这么简单
iPhone 本地解密通知,点开即可在 Topic 里查看。
可交互的产品流程演示,二维码和消息均为示例。 了解完整流程 →
在手机创建或选择 Topic 后,扫码授权对应发送端。手机分别授权每个来源与浏览器;中继处理路由元数据、时间、大小与请求状态,不读取消息明文。Web 仅收到授权后发给它的新消息。
Topic 是订阅通道
Topic 可以叫“工作”“构建”或“备份”。免费版包含一个活跃 Topic;Ntfyx Plus 可使用最多二十个。向已有 Topic 添加发送端或浏览器不等于创建新 Topic。连接数量、消息频率与存储限制仍然适用。
点击 Topic 标题可以展开或收起消息。每日静音默认时段为 22:00–09:00,默认关闭;开启后只暂停推送提醒,消息仍然送达,回复仍然可用。
Web 收件箱
在电脑打开 Web Inbox,用手机扫描浏览器二维码并授权。浏览器使用独立密钥,只能查看授权后发给它的新消息,也可以回答问题。手机可以撤销浏览器访问;撤销不能删除浏览器已经收到的内容。
加密保护什么?
消息标题、正文、选项、显示名称与回复在设备上先加密,再发送到中继服务。接收端在本地解密,并核验签名。服务仍需处理不透明标识符、时间、大小、路由与通知令牌;端到端加密不代表没有元数据,也不能保护已经被入侵的设备。
恢复 Plus 购买权益不会恢复加密密钥。请单独保管恢复文件与恢复码;客服不能解密丢失密钥的消息。目前尚未完成独立安全审计。
Codex 额度与 reset 卡提醒
Ntfyx 在你的电脑上读取 Codex 用量(只读,不读取 Codex 登录文件,也不会使用 reset 卡),只把提醒内容端到端加密后发到手机:新的 reset 卡、未使用的 reset 卡将在 3 天或 24 小时内过期、用量达到 80% 或 95%、用过一半以上的额度窗口已重置、额度用完或恢复可用。首次检查只发一条概况。
ntfyx watch codex-usage --dry-run
ntfyx setup codex-usagesetup 会在 Linux 安装 systemd 用户定时器,在 macOS 安装 LaunchAgent,默认每 15 分钟检查一次;--remove 可卸载。完整说明(英文)
Agent、ChatGPT 与 Claude
Claude Code 与 Codex 可以把权限请求发到手机审批(ntfyx setup claude-code、ntfyx setup codex,也可以用插件安装),pi 有对应的扩展包,其他支持 CLI 或本地 stdio MCP 的 Agent 可以使用 Ntfyx 通知与提问工具。已验证的版本与平台见 Agent 说明。当前没有在 ChatGPT 或 Claude 应用目录发布集成;能在 AI 搜索中找到官网,与在聊天应用中直接调用工具,是不同的能力。