cc-notify-hooks — AI Agent 时代的注意力调度器

问题

Agent 在等你，你不知道

这些场景每天都在发生。

⏳

权限确认卡了 20 分钟

Claude 需要你点一下"允许"，你切到浏览器看了篇文章，回来发现它等了你半小时。

😴

任务完成了但你不知道

跑了个大重构，你去喝咖啡。回来一看——10 分钟前就完成了，白等了。

🎮

多个 Agent 同时跑

3 个终端窗口 3 个任务。你根本记不住哪个需要你介入，哪个还在自己跑。

💪

离开电脑就失联

开个会回来，发现 Agent 在第 3 分钟就卡住了，剩下 57 分钟纯浪费。

模板

短通知负责打断，长通知负责定位

通知会先归一成同一批字段。短渠道只显示项目和一句摘要；Codex 等待结构化输入时还会显示问题数和 Session，长渠道再补 cwd 与首题选项。

长通知卡片示例

飞书使用消息卡片，企业微信 / 钉钉 / Slack / Discord 使用近似模板。

请选择这次修复的范围

项目: cc-notify-hooks
事件: PreToolUse
工具: request_user_input
问题数: 2
选项: 完整修复 / 最小补丁
Session: 019eabcd-1234-5678

GPT-5 · /Users/mariozzj/Documents/project/cc-notify-hooks · Mario5Air

机制

短通知 + 长通知，两级调度

推送前检查你是否已响应。回来了就停，没回来就升级。

事件触发

Claude Code 或 Codex 需要权限确认 / 等待输入 / 任务完成时触发。Codex 的 request_user_input 由 PreToolUse 精确识别，回答后的 PostToolUse 定向取消延迟通知。

3 ~ 15s

短通知 — 即时触达

macOS 系统弹窗、Telegram 消息、Bark / Pushover / ntfy 手机推送。只显示 Agent、状态、项目和一句短摘要，不塞权限细节。

✓ 你看到通知回来了？后面的推送自动取消。

5 min

长通知 — 异步兜底

企业微信 / 飞书 / 钉钉 / Slack / Discord 群消息。飞书使用消息卡片，其余渠道用近似 Markdown / embed 模板，第一行就是短摘要。

✓ 短通知已经解决了？长通知不会再发。零噪音。

安装

两行命令，即刻生效

Claude Code 与 Codex CLI 双支持，插件一键安装或独立脚本部署。

在 Claude Code 中执行：

/plugin marketplace add MarioZZJ/cc-notify-hooks
/plugin install cc-notify-hooks@cc-notify-hooks

安装后运行 /cc-notify-hooks:config 启动交互式配置向导。

添加 marketplace 并安装插件：

codex plugin marketplace add MarioZZJ/cc-notify-hooks --ref v2.3.1
codex plugin add cc-notify-hooks@cc-notify-hooks

在 ~/.codex/config.toml 启用 hooks（必需）：

[features]
codex_hooks = true

Marketplace 位于仓库根目录，实际插件目录是 plugins/cc-notify-hooks/。

Codex hook 使用 PLUGIN_ROOT 定位脚本、使用 PLUGIN_DATA 保存配置和 Session 状态，不依赖固定缓存路径。安装或升级后请在 /hooks 中审阅并信任变更后的 hooks。

git clone https://github.com/MarioZZJ/cc-notify-hooks.git
cd cc-notify-hooks
bash install.sh                  # 交互式选择目标
bash install.sh claude           # 直接装到 Claude Code
bash install.sh codex            # 直接装到 Codex CLI

安装脚本会交互式引导你选择渠道、输入凭证，自动写入对应工具的配置。

特性

为 Agent 工作流设计

⚡ 智能取消

用户回来操作，排队中的推送全部作废。不会重复打扰。

🔇 子智能体过滤

子任务不会触发推送，只有主 Agent 的关键事件才会通知你。

🕑 Rate Limiting

按 Session + 事件类别限流；结构化问题使用 tool_use_id 精确去重，不会吞掉下一次真实提问。

🔧 延迟可调

每个渠道独立设置延迟。Telegram 5 秒、Bark 30 秒、飞书 10 分钟，你说了算。

🌏 macOS 零配置

macOS 用户装完即用，系统原生通知，不需要注册任何服务。

🔌 Claude & Codex 双支持

同一份配置覆盖 Claude Code 与 Codex CLI。两套清单，两个 marketplace 入口，一次配置全部生效。

💬 结构化问题通知

Codex 调用 request_user_input 后立即进入现有通知队列；回答后只取消当前 Session 尚未发送的提醒。

人可以闲着
Agent 不可以