777genius/claude-notifications-go

何を解決するか

Claude Codeを使用する際、常にターミナルを監視する必要がありません。スマートなデスクトップ通知とWebhook通知により、長時間実行されるAIタスクの完了、AIからの質問、エラー発生時にユーザーに通知し、重要な更新を逃すことなくマルチタスクが可能になります。

動作方法

このプロジェクトはClaude Code用のプラグインとして機能し、AIのライフサイクル（例：PreToolUseやStopフック）に接続します。AIの状態を監視（タスク完了、コードレビュー、APIエラーなど）し、ネイティブOSのデスクトップアラートまたは設定されたWebhook経由で通知を発行します。音声再生、ウィンドウのフォーカス、外部API呼び出しの処理を担当するGo言語ベースのバイナリが含まれています。

対象ユーザー

長時間実行タスクや複数のターミナルウィンドウで複雑なワークフローを扱う開発者で、バックグラウンドでAIの進捗を通知してほしい方。

特徴

• クリックしてフォーカス: 通知をクリックすると、Ghostty、VS Code、iTerm2など幅広いターミナルおよびtmux、zellijなどのマルチプレクサで、特定のプロジェクトウィンドウとタブを自動的にフォーカスします。
• マルチチャネルアラート: ネイティブデスクトップ通知と、Slack、Discord、Telegram、Microsoft Teamsなど幅広いWebhookをサポート。
• 文脈認識: 通知のタイトルに現在のGitブランチを表示でき、ユーザーがアクティブなターミナルにすでにフォーカスしている場合はアラートを抑制します。
• カスタマイズ可能な音声: MP3、WAV、FLACなどさまざまな音声フォーマットをサポート。音量調整可能で、特定のオーディオデバイスに音声をルーティングできます。
• クロスプラットフォーム: macOS、Linux、Windows 10+ に対してネイティブサポート。