Claude Code Notification

Method 1: One-Command Setup (Recommended)

cd /path/to/ccnotify && npm run setup-hooks

git clone <this-repository> cd ccnotify npm install && npm run build

- Restart Claude Codeif it's currently running

All Claude Code notifications will now automatically have enhanced sounds and styling. No additional configuration needed!

The notification hook automatically detects and enhances all Claude Code notifications:

- ✅Success/Completion→ Glass sound (macOS)
- 🚨Errors/Failures→ Basso sound (macOS)
- ⚠️Warnings/Attention→ Sosumi sound (macOS)
- 💡Info/Updates→ Blow sound (macOS)
- ⏳Progress/Ongoing→ Tink sound (macOS)

# Building a project npm run build # → Automatic success notification with Glass sound when complete # → Automatic error notification with Basso sound if failed # Running tests npm test # → Automatic progress notification with Tink sound while running # → Automatic completion notification when finished # Git operations git push origin main # → Automatic notifications for each step with appropriate sounds

Edit the hook script athooks/notification-hook.jsto customize sound mappings:

// Example: Add custom sound rules const customSoundRules = ](https://github.com/nkygit/cat-ccnotify-hook)[ { pattern: /deployment/i, sound: 'Ping' }, { pattern: /security/i, sound: 'Funk' }, { pattern: /backup/i, sound: 'Purr' } ];

# Check if hook is properly installed cat ~/.config/claude-code/settings.json | grep -A 10 "hooks" # Verify hook script is executable ls -la hooks/notification-hook.js # Re-run setup if needed npm run setup-hooks

# Test system sound (macOS) afplay /System/Library/Sounds/Glass.aiff # Check notification permissions in System Preferences

Claude Code Operations→Enhanced Notifications

# File operations "Create a new React component" → ✅ "Component created successfully" + Glass sound # Build processes "Run the build process" → ⏳ "Build in progress..." + Tink sound → ✅ "Build completed successfully" + Glass sound # Error scenarios "Fix the TypeScript errors" → 🚨 "3 type errors found" + Basso sound # Git operations "Commit these changes" → ✅ "Changes committed successfully" + Glass sound

npm run dev # Development mode with auto-reload npm run build # Production build npm start # Start production server

- macOS: Full native support withosascriptand system sounds
- Windows/Linux: Cross-platform support vianode-notifierpackage

- Type-safe TypeScript implementation
- MCP (Model Context Protocol) compliant
- Automatic platform-specific implementation switching
- Extensible notification type system

The notification hook intercepts Claude Code's notification system and enhances it:
- Interception: Hook receives all notification calls from Claude Code
- Analysis: Analyzes notification content using pattern matching
- Enhancement: Adds appropriate sounds and styling based on content
- Native Integration: Uses platform-specific notification APIs

~/.config/claude-code/settings.json # Claude Code configuration hooks/notification-hook.js # Main hook script dist/index.js # Built MCP server (optional) scripts/setup-hooks.js # Automated setup script

- macOS: Full native support withosascriptand system sounds
- Windows/Linux: Cross-platform support vianode-notifierpackage

For advanced users who want manual notification control, the MCP server is still available:

{ "mcpServers": { "ccnotify": { "command": "node", "args": ["/absolute/path/to/ccnotify/dist/index.js"] } } }

Bug reports and feature requests are welcome! Please open anissue.

A chat assistant that integrates an MCP client with an LLM and other external MCP servers.