Claude Code Notifications Plugin

Cross-platform notification system for Claude Code with sound and window highlighting.

Features

• Sound Notifications: Custom audio alerts for different events
• Window Highlighting: Flash window title bar to get your attention
• Event Types: stop, tool_complete, permission, error
• Configurable: Enable/disable sound and highlight per event

Installation

# Install dependencies
pip install -r requirements.txt

Usage

/notify                    # Toggle notifications
/notify --status           # Show current status
/notify --enable           # Enable notifications
/notify --disable          # Disable notifications

Configuration

Edit notification_config.json to customize:

{
  "enabled": true,
  "sound_enabled": true,
  "highlight_enabled": true,
  "events": {
    "stop": {"enabled": true, "sound": true, "highlight": true},
    "tool_complete": {"enabled": true, "sound": true, "highlight": true},
    "permission": {"enabled": true, "sound": false, "highlight": true},
    "error": {"enabled": true, "sound": true, "highlight": true}
  }
}

Sound Files

Place custom MP3 files in resources/audio/:

• complete.mp3 - Task completion
• tool_complete.mp3 - Tool completion
• permission.mp3 - Permission request
• error.mp3 - Error occurred
• notice.mp3 - Default notification