-
Notifications
You must be signed in to change notification settings - Fork 1
Releases: RonitSachdev/ccnudge
CCNudge v1.0.0
CCNudge v1.0.0 - Initial Release 🎉
Get sound and desktop notifications for Claude Code events!
Features
🎵 Sound notifications - Hear when Claude Code events trigger
🔔 Desktop notifications - Get visual alerts too
🎯 Multiple events - Configure different sounds for 9 different Claude Code events
⚡ Simple commands - ccnudge start / ccnudge stop
🎨 Interactive setup - Easy configuration wizard
🖥️ Cross-platform - Works on macOS, Linux, and Windows
💾 Preserves settings - Stop/start without reconfiguring
🎵 Custom sounds - Use system sounds or your own audio files
Available Events
- Stop - When Claude finishes responding (most common)
- SubagentStop - When subagent tasks complete
- PostToolUse - After tool calls complete
- PreToolUse - Before tool calls
- UserPromptSubmit - When user submits a prompt
- Notification - When Claude sends notifications
- SessionStart - When session starts/resumes
- SessionEnd - When session ends
- PreCompact - Before compact operations
Installation
```bash
npm install -g ccnudge
```
The interactive setup will run automatically after installation!
Quick Start
```bash
Setup runs automatically on install, or run manually:
ccnudge setup
Check status
ccnudge status
Disable temporarily
ccnudge stop
Re-enable
ccnudge start
```
Links
Note: Make sure to grant notification permissions to your Terminal/iTerm on macOS for desktop notifications to work!