Table of content
macOS notifications for Claude Code events
Installation
npx claude-plugins install @udecode/dotai/notification
Contents
Folders: hooks
Files: README.md
Documentation
macOS notifications for Claude Code events.
Features
Displays native macOS notifications for:
- Stop - Shows “Claude finished responding” when Claude stops
- PreCompact - Shows “Compacting conversation…” before context compaction
- Notification - (Disabled by default) Shows system notifications
Prerequisites
Requires terminal-notifier to be installed:
brew install terminal-notifier
Installation
/plugin marketplace add udecode/dotai
/plugin install notification@dotai
Restart Claude Code to activate the hooks.
What You’ll See
- 🔔 Ping sound - When Claude finishes responding
- 🍾 Bottle sound - When compacting conversation history
- 📝 Dynamic titles - Shows the conversation summary as notification title
How It Works
The plugin uses hooks to intercept Claude Code events and displays notifications with:
- Title: Extracted from conversation transcript summary
- Message: Event-specific message
- Sound: Different sounds for different events
Customization
Edit .claude-plugin/plugins/notification/hooks/hooks.json to:
- Change notification sounds (
Ping,Bottle,Glass,Submarine, etc.) - Modify messages
- Enable/disable specific notifications
- Adjust matcher patterns
Troubleshooting
Notifications not appearing:
- Check terminal-notifier is installed:
which terminal-notifier - Enable notifications for Terminal/iTerm in System Settings → Notifications
- Verify plugin is enabled:
/plugin
Want to disable:
/plugin disable notification@dotai
License
MIT