777genius/agent-notifications

解决的问题

Agent Notifications 提供了一种无需持续监控终端即可了解 Claude Code 和 Codex CLI 等 AI 代理进度的方法。它通过在特定代理事件（如任务完成、API 错误或需要用户输入）发生时发送系统通知、播放声音并触发 Webhook，解决了"盲目等待"的问题。

工作原理

该项目是一个跨平台插件，可与代理的钩子系统集成。它会监控特定触发器（如 Stop 或 PreToolUse 钩子），并将这些事件映射为通知。例如，它可根据状态机和文本启发式方法检测任务是否完成，或是否需要用户提问。它还包含「点击聚焦」功能，利用平台特定 API（如 macOS 的 AX API 或 Linux 的 D-Bus）在点击通知时自动将正确的终端窗口、标签页或窗格重新聚焦。

适用人群

希望在 AI 代理于后台执行复杂且耗时的任务时，通过多任务处理提升效率的 Claude Code 或 Codex CLI 用户。

主要亮点

• 多代理支持：兼容 Claude Code 和 Codex CLI。
• 深度终端集成：支持广泛的终端（Ghostty、VS Code、iTerm2、Warp、kitty、WezTerm 等）和多路复用器（tmux、zellij）的点击聚焦功能。
• 丰富通知：支持声音提醒（MP3/WAV/FLAC/OGG/AIFF）和通知标题中显示 Git 分支信息。
• 广泛的 Webhook 集成：支持 Slack、Discord、Telegram、Microsoft Teams、ntfy.sh、PagerDuty 等，内置重试和速率限制功能。
• 跨平台：原生支持 macOS、Linux 和 Windows 10+。