"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
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.
See what it looks like in action — click the thumbnail to play:
/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.
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-projectThen restart Claude Code. This copies hooks into .claude/hooks/ and registers them in .claude/settings.json.
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 | bashSame as Option B — installs into the current project only.
git clone https://github.com/dragon1086/claude-code-sounds
cd claude-code-sounds && ./install.shImportant
Restart Claude Code after install for hooks to activate.
- Python 3
- macOS (
afplay), Linux (paplay/aplay/ffplay), or Windows (built-inwinsound)
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 |
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.
| 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 | — |
Tip
Contributions welcome! Any theme, any fandom, any language — it takes about 15 minutes. See packs/README.md for the full guide.
| Pack | Author | Description |
|---|---|---|
| (be the first!) |
The flagship pack of this project. Real anime voices from the One Piece series — Luffy, Zoro, Nami, Robin, Franky, Brook, and more — each matched to a Claude Code lifecycle event.
See packs/onepiece/ for the full track list.
Plugin marketplace (user scope) — most common:
bash "$(find ~/.claude/plugins/cache/claude-code-sounds -name "claude-sounds.sh" | sort -V | tail -1)" use onepieceNo reinstall needed. The change takes effect immediately.
install.sh / manual clone:
# Step 1: switch the pack in the repo
./claude-sounds.sh use onepiece
# Step 2: re-apply to your project
./install.sh --forceTo see which pack is currently active: ./claude-sounds.sh current
To list all available packs: ./claude-sounds.sh list
Replace any file in .claude/hooks/sounds/{event}/:
.claude/hooks/sounds/stop/
└── stop.wav ← replace this with your own sound
File name must match the folder name. Both .wav and .mp3 are supported (.wav tried first).
Certain bash commands trigger dedicated sounds. For example, git commit plays pretooluse-git-committing.wav instead of the generic pretooluse.wav.
Add your own patterns in hooks.py:
BASH_PATTERNS = [
(r'git commit', "pretooluse-git-committing"), # included by default
(r'npm test', "pretooluse-npm-testing"), # add your own
(r'rm -rf', "pretooluse-danger"),
(r'git push', "pretooluse-git-pushing"),
]Each pattern needs a matching file in sounds/pretooluse/pretooluse-{name}.wav.
To disable individual hooks without uninstalling, create .claude/hooks/config/hooks-config.local.json (git-ignored):
{
"disablePostToolUseHook": true,
"disableLogging": true
}See hooks/config/hooks-config.local.json.example for all available options.
Subagent sessions can play different sounds. Wire hooks in your agent frontmatter:
---
name: my-agent
hooks:
PreToolUse:
- type: command
command: python3 $CLAUDE_PROJECT_DIR/.claude/hooks/scripts/hooks.py --agent=my-agent
async: true
timeout: 5000
Stop:
- type: command
command: python3 $CLAUDE_PROJECT_DIR/.claude/hooks/scripts/hooks.py --agent=my-agent
async: true
timeout: 5000
---Sound files go in agent_pretooluse/, agent_stop/, etc.
./uninstall.shInspired by shanraisshan/claude-code-best-practice, which first demonstrated wiring audio feedback into Claude Code hooks. This project extracts and generalizes that idea into a standalone, installable plugin with full hook coverage, sound packs, and cross-platform support.
MIT