777genius/claude-notifications-go

What it solves

It eliminates the need to constantly monitor the terminal while using Claude Code. By providing smart desktop and webhook notifications, it alerts users when long-running AI tasks are complete, when the AI has a question, or when errors occur, allowing users to multitask without missing critical updates.

How it works

The project acts as a plugin for Claude Code, hooking into the AI's lifecycle (such as PreToolUse and Stop hooks). It monitors the AI's state—detecting events like task completion, code reviews, or API errors—and triggers notifications via native OS desktop alerts or configured webhooks. It includes a Go-based binary that handles the heavy lifting of audio playback, window focusing, and external API calls.

Who it’s for

Developers using Claude Code who want to be notified of AI progress in the background, especially those working with long-running tasks or complex workflows across multiple terminal windows.

Highlights

• Click-to-Focus: Clicking a notification can automatically bring the specific project window and tab back into focus across a wide variety of terminals (Ghostty, VS Code, iTerm2, etc.) and multiplexers (tmux, zellij).
• Multi-Channel Alerts: Supports native desktop notifications and a wide array of webhooks including Slack, Discord, Telegram, and Microsoft Teams.
• Contextual Awareness: Displays the current Git branch in the notification title and can suppress alerts if the user is already focused on the active terminal.
• Customizable Audio: Supports various audio formats (MP3, WAV, FLAC, etc.) with volume control and the ability to route sounds to specific audio devices.
• Cross-Platform: Native support for macOS, Linux, and Windows 10+.