项目地址: https://github.com/LetTTGACO/agent-notify/blob/main/README-CN.md
通过接收 AI Agent 原始 hook 事件,在服务端格式化成简短、行动导向的通知,并通过 Bark 或 ntfy 推送到你的手机或桌面。
它能做什么
- 接收 AI Agent 原始 hook 事件。
- 在服务端格式化简短、行动导向的通知(权限请求、提问、错误、长任务完成)。
- 让短任务(默认 120 秒以内)保持安静,只在会话运行时间足够长时提醒你。
- 用防抖/节流限制 60s 之内的多次权限通知,减少权限/问题提醒刷屏。
- 提供按工具独立的
/agent-notify开关(本质是 skill ),支持当前会话、定时和持久静音。 - 通过 Bark ( iPhone / Apple Watch )或 ntfy (跨平台)推送。
我为什么开发这个工具
目前我是使用 Codex 桌面端作为主力,Claude Code/OpenCode 偶尔用。
我日常遇到的痒点:
- 单项目开发时。AI 处理稍长一点的任务时,我可能在摸鱼刷社区软件,任务完成后我不一定知道。Codex 桌面端有相关设置,可以解决,但是 Agent Cli 工具没有。
- 多项目开发时。即使是 Codex 桌面端,也只能设置应用失焦时通知,要么就全通知。所以我在应用内时,其他任务完成后我需要个完成提醒。
- 偶尔在外面和家里的 Codex 下达任务时,我想用 Apple Watch 提醒我。
- 我有时候需要通知到我的手机端/手表而不是电脑端。
- 连续专注开发时不需要什么提醒,需要一个快捷开关永久/短暂关闭通知。
其实这些算不上什么问题,有时候无非是浪费点时间而已,我连续开发时也很少用。
如果你有类似场景的话,有需要可以试试。
安装
可以 clone 我的项目,用 AI Agent 进入项目根目录后,将 AI 使用手册发给 AI 来安装。
手机端示例
