v0.2 — early release, more sounds and themes coming soon
Your Claude Code shouldn't be silent. Carefully selected sounds for 10 key events — writes, reads, bash, web, agents, prompts. 21 sound files with random selection for variety. Drop your own mp3s to customize.
claude plugins marketplace add https://github.com/culminationAI/claude-marketplace
claude plugins install claude-sounds@culmination-marketplaceRestart Claude Code after installation.
macOS, Linux, Windows
| Event | Pattern | Description |
|---|---|---|
| Write / Edit | write-*.mp3 |
Pen & pencil scratching |
| Read / Grep / Glob | read-*.mp3 |
Page flipping |
| Bash | bash-pre-*.mp3 |
Force pulse |
| WebSearch | web-search-*.mp3 |
Electric crackle |
| WebFetch | web-fetch-*.mp3 |
Curse spell |
| Agent started | agent-start-*.mp3 |
Spawn sound |
| Agent finished | agent-stop-*.mp3 |
Completion chime |
| User prompt | user-prompt-*.mp3 |
Stone tap |
| Stop | stop-*.mp3 |
Birds chirping |
| Notification | notification-*.mp3 |
Alert ping |
All hooks use random selection from matching files. To add variety, just drop more mp3s following the naming pattern:
sounds/
├── write-01.mp3
├── write-02.mp3 ← add your own
├── write-03.mp3
├── read-01.mp3
├── bash-pre-01.mp3
├── bash-pre-02.mp3 ← add your own
└── ...
Included sounds sourced from:
- Kenney (CC0)
- OpenGameArt (CC0 / CC-BY)
- BigSoundBank (CC0)
- Custom recordings
- More sound themes (sci-fi, nature, retro)
- Linux support (
paplay/aplay) - Theme switching command
- Volume control per hook
MIT