777genius/claude-notifications-go

解決的問題

使用 Claude Code 時無需持續監控終端。透過智慧型桌面通知與 Webhook 通知，當長時間執行的 AI 任務完成、AI 提出問題或發生錯誤時，系統會即時提醒使用者，讓使用者能安心進行多工處理，不會錯過關鍵更新。

工作原理

此專案作為 Claude Code 的外掛程式，透過鈎子（如 PreToolUse 和 Stop）接入 AI 的生命週期。它監控 AI 的狀態（如任務完成、程式碼審查或 API 錯誤），並透過原生作業系統桌面通知或設定的 Webhook 觸發提醒。專案包含一個 Go 編寫的二進位檔，負責音訊播放、視窗聚焦和外部 API 呼叫等繁重任務。

適用對象

希望在背景接收 AI 進度通知的 Claude Code 使用者，特別是處理長時間執行任務或跨多個終端視窗的複雜工作流程的開發者。

特色亮點

• 點擊聚焦：點擊通知可自動將特定專案視窗和標籤頁聚焦至各種終端（Ghostty、VS Code、iTerm2 等）和多路複用器（tmux、zellij）中。
• 多通道提醒：支援原生桌面通知，以及 Slack、Discord、Telegram、Microsoft Teams 等多種 Webhook。
• 上下文感知：通知標題中顯示目前 Git 分支，並在使用者已聚焦於活動終端時自動抑制提醒。
• 可自訂音訊：支援 MP3、WAV、FLAC 等多種音訊格式，可調節音量，並可將聲音路由至特定音訊裝置。
• 跨平台支援：原生支援 macOS、Linux 和 Windows 10+。