777genius/agent-notifications

何を解決するか

Agent Notifications は、Claude Code や Codex CLI などの AI エージェントの進行状況を、常にターミナルを監視しなくても把握できるようにします。『目隠し待ち』の問題を解決するために、特定のエージェントイベント（タスク完了、API エラー、ユーザー入力の要求など）が発生した際に、システム通知を送信し、音声を再生し、Webhook をトリガーします。

動作方法

このプロジェクトは、エージェントのフックシステムと統合するクロスプラットフォームプラグインです。Stop や PreToolUse などの特定のフックを監視し、これらのイベントを通知にマッピングします。たとえば、ステートマシンとテキストヒューリスティクスに基づいて、タスクの完了やユーザーへの質問の発生を検出できます。また、『クリックでフォーカス』機能も搭載されており、macOS の AX API や Linux の D-Bus などのプラットフォーム固有の API を使って、通知をクリックした際に正しいターミナルウィンドウ、タブ、またはパネルを自動的にフォーカスに戻します。

対象ユーザー

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+ に対してネイティブ対応。