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+。