使用说明

CLI 发通知,Agent 来提问,手机上处理。

Ntfyx(notify x to me)让 CLI、脚本和 Agent 把加密通知与问题发送到你的 iPhone,也可以由手机授权浏览器,在 Web 收件箱处理。

从安装到第一条消息

需要 macOS 或 Linux 电脑与可用的 Ntfyx iPhone 版本。iPhone App 目前正在等待 App Store 审核,尚未宣布公开下载。

  1. 在电脑安装 CLI,并运行 ntfyx connect,显示连接二维码。
  2. 在手机创建一个自己命名的 Topic,使用其中的 Connect Topic 扫码并确认来源。
  3. 电脑运行 ntfyx send 发送通知;需要你回答时,运行 ntfyx ask。
  4. 在手机查看通知或回复;发送端验证回复签名后,按对应操作的规则继续。
curl -fsSL https://ntfyx.me/install.sh | bash
ntfyx connect
ntfyx send "备份完成"
ntfyx ask "继续执行?" --allow-deny

从电脑,到你的口袋

看得见的连接过程。

●   TerminalWork   ·   9:41
ntfyx — zsh
❯ ntfyx connect
演示二维码,不能用于实际连接
连接你的 iPhone

打开 Ntfyx → 连接 Topic

等待手机扫码…✓   Work · 已连接
二维码仅限一次 · 5 分钟有效
✓ Work · iPhone 已连接
❯ ntfyx send "Build passed"
↗   已在本地加密✓   消息已接收 Work
❯
你的电脑 CLI / Agent
9:41
Ntfyx

让工作, 随时联系你。

连接 Topic,接收第一条消息。

连接 Topic×

对准电脑上的二维码

✓已识别连接码Topic Work
Ntfyx+

收件箱

Work1 条消息0
✓连接成功

电脑发来的消息会显示在这里。

Terminal 9:41Build passed

来自你的电脑。 在 iPhone 本地解密。

⌁ 端到端加密

9 月 29 日 星期二

9:41点一下通知,查看消息 ↑
你的 iPhone
01 / 04

电脑发起连接

运行 ntfyx connect,生成一次性连接二维码。

可交互的产品流程演示,二维码和消息均为示例。 了解完整流程 →

完整快速开始(英文) · 下载与可用状态

消息链路 · 每个接收端收到独立的加密副本
CLI / Agent加密并签名
Ntfyx 中继密文与推送唤醒
iPhone / Web验证并解密
签名并加密的回复返回原发送端

在手机创建或选择 Topic 后,扫码授权对应发送端。手机分别授权每个来源与浏览器;中继处理路由元数据、时间、大小与请求状态,不读取消息明文。Web 仅收到授权后发给它的新消息。

Topic 是订阅通道

Topic 可以叫“工作”“构建”或“备份”。免费版包含一个活跃 Topic;Ntfyx Plus 可使用最多二十个。向已有 Topic 添加发送端或浏览器不等于创建新 Topic。连接数量、消息频率与存储限制仍然适用。

点击 Topic 标题可以展开或收起消息。每日静音默认时段为 22:00–09:00,默认关闭;开启后只暂停推送提醒,消息仍然送达,回复仍然可用。

免费版与 Plus · 服务限制

Web 收件箱

在电脑打开 Web Inbox,用手机扫描浏览器二维码并授权。浏览器使用独立密钥,只能查看授权后发给它的新消息,也可以回答问题。手机可以撤销浏览器访问;撤销不能删除浏览器已经收到的内容。

打开 Web 收件箱 · 浏览器使用说明

加密保护什么?

消息标题、正文、选项、显示名称与回复在设备上先加密,再发送到中继服务。接收端在本地解密,并核验签名。服务仍需处理不透明标识符、时间、大小、路由与通知令牌;端到端加密不代表没有元数据,也不能保护已经被入侵的设备。

恢复 Plus 购买权益不会恢复加密密钥。请单独保管恢复文件与恢复码;客服不能解密丢失密钥的消息。目前尚未完成独立安全审计。

安全模型 · 隐私与保留期限 · 恢复指南

Codex 额度与 reset 卡提醒

Ntfyx 在你的电脑上读取 Codex 用量(只读,不读取 Codex 登录文件,也不会使用 reset 卡),只把提醒内容端到端加密后发到手机:新的 reset 卡、未使用的 reset 卡将在 3 天或 24 小时内过期、用量达到 80% 或 95%、用过一半以上的额度窗口已重置、额度用完或恢复可用。首次检查只发一条概况。

ntfyx watch codex-usage --dry-run
ntfyx setup codex-usage

setup 会在 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 搜索中找到官网,与在聊天应用中直接调用工具,是不同的能力。

Agent 与 MCP 配置 · 脚本通知示例 · 常见问题 · English documentation