"In the AI age, taste will become even more important. When anyone can make anything, the big differentiator is what you choose to make."
— Paul Graham, Y Combinator
✦ Where your AI gets taste. ✦
Audio feedback for every Claude Code lifecycle event — powered by the native hooks system. Ships with real ElevenLabs-generated voice files. Swap any sound by replacing one file.
Demo
See what it looks like in action — click the thumbnail to play:
⚙️ How it works
🚀 Install
Option A — Plugin marketplace (recommended)
/plugin marketplace add https://github.com/dragon1086/claude-code-sounds
/plugin install claude-code-sounds
When prompted for scope:
| Choice | What happens |
|---|
| user (global) ✅ | Sounds play in every project automatically |
| project | Sounds silent — run setup-project once per project (see below) |
| local | Same as project, but excluded from git (personal config) — also needs setup-project |
[!IMPORTANT]
Restart Claude Code after install for hooks to activate.
Project-scope fix
If you chose project scope (or want per-project opt-in), run once inside the project:
bash "$(find ~/.claude/plugins/cache/claude-code-sounds -name "claude-sounds.sh" | head -1)" setup-project
Then restart Claude Code. This copies hooks into .claude/hooks/ and registers them in .claude/settings.json.
Option B — curl (project scope)
Installs into the current project's .claude/hooks/. Run from inside a project directory. Repeat for each project you want sounds in.
curl -fsSL https://raw.githubusercontent.com/dragon1086/claude-code-sounds/main/install.sh | bash
Option C — Manual clone (project scope)
Same as Option B — installs into the current project only.
git clone https://github.com/dragon1086/claude-code-sounds
cd claude-code-sounds && ./install.sh
[!IMPORTANT]
Restart Claude Code after install for hooks to activate.
📋 Requirements
- Python 3
- macOS (
afplay), Linux (paplay / aplay / ffplay), or Windows (built-in winsound)
🪝 Hook Coverage
All 27 Claude Code hook events are wired, plus 6 agent-scoped events:
| Category | Events |
|---|
| Session | SessionStart, SessionEnd, Setup |
| Tool | PreToolUse, PostToolUse, PostToolUseFailure, PermissionRequest, PermissionDenied |
| Turn | UserPromptSubmit, Stop, StopFailure, Notification |
| Subagent | SubagentStart, SubagentStop, TeammateIdle, TaskCreated, TaskCompleted |
| Context | PreCompact, PostCompact, InstructionsLoaded, ConfigChange |
| Environment | CwdChanged, FileChanged, WorktreeCreate, WorktreeRemove |
| MCP | Elicitation, ElicitationResult |
🎵 Sound Packs
Switch all sounds at once using the claude-sounds.sh use command. This is the only way to switch packs — activePack in hooks-config.json is a tracking label only and does not affect which sounds are played.
Built-in Packs
| Pack | Description | Source |
|---|
🏴☠️ onepiece | [Flagship] Real One Piece anime voices — Luffy, Zoro, Robin, Franky, Brook and more | Original anime |
🎮 faker | T1 Faker (이상혁) — ElevenLabs IVC voice clone | ElevenLabs IVC |
⚔️ kimetsu | Demon Slayer (鬼滅の刃) — Tanjiro, Rengoku, Zenitsu, Inosuke and more | ElevenLabs TTS |
🔊 best-practice | ElevenLabs "Samara X" — ported from claude-code-best-practice | ElevenLabs TTS |
💬 devquotes-en | Developer motivational quotes — real wisdom from Torvalds, Knuth, Beck and more | ElevenLabs TTS |
💬 devquotes-ko | 개발자 동기부여 명언 (KO) — Torvalds, Knuth, Beck 등 실제 명언 | ElevenLabs TTS |
🔇 silent | 100ms silence — disables all sounds without removing hooks | — |
⚙️ default | Minimal default sound set | — |
Community Packs
