claude-code-hooks
shanraisshan · shanraisshan/claude-code-hooks
Adds distinct audio cues to Claude Code actions like session start, tool use, and agent responses, enhancing real-time feedback for the user.
claude code hooks - adding voice on each hook
Preview
What you can do with it
- Receive audible confirmation when Claude Code starts a new session or uses a tool.
- Get distinct sound alerts for agent responses, even when focused on another window.
- Customize audio feedback for specific agent actions to create a more engaging coding experience.
Safety check
No risky patterns found in the files we scanned.
Automated scan of the repo files. Always review code you run.
From the README
Claude Code Hooks
-white?style=flat&labelColor=555)
Demo Video + Presentation
Installation
Step 1. Start Claude Code:
claude
Step 2. Send a prompt (e.g., Hi) — you'll hear a sound on session start, tool use, agent response, and more.
Common Errors
If you don't follow the prerequisites, you will see the following error on claude code start
SessionStart:startup hook error
Changelog
new hook addition changelogs only
| Date | Hooks | Changes | Claude Code Version | Demo |
|---|---|---|---|---|
| Jun 04, 2026 | 30 | Added MessageDisplay | v2.1.152 | |
| Jun 04, 2026 | 29 | Added PostToolBatch | docs | |
| Jun 04, 2026 | 28 | Added UserPromptExpansion | docs | |
| Mar 31, 2026 | 27 | Added PermissionDenied | v2.1.88 | |
| Mar 26, 2026 | 26 | Added TaskCreated | v2.1.84 | Demo 4 |
| Mar 25, 2026 | 25 | Added CwdChanged, FileChanged | v2.1.83 | |
| Mar 18, 2026 | 23 | Added StopFailure | v2.1.78 | |
| Mar 14, 2026 | 22 | Added PostCompact, Elicitation, ElicitationResult | v2.1.76 | |
| Mar 5, 2026 | 19 | Added InstructionsLoaded | v2.1.69 | |
| Feb 21, 2026 | 18 | Added WorktreeCreate and WorktreeRemove | v2.1.50 | |
| Feb 20, 2026 | 16 | Added ConfigChange | v2.1.49 | |
| Feb 6, 2026 | 15 | Added TeammateIdle and TaskCompleted | v2.1.33 | |
| — | 13 | Added PostToolUseFailure | — | Demo 3 |
| Jan 17, 2026 | 12 | Added Setup | v2.1.10 | |
| Jan 7, 2026 | 12 | Added subagent hooks: PreToolUse, PostToolUse, Stop | v2.1.0 | |
| Nov 18, 2025 | 11 | Added PermissionRequest | v2.0.45 | Demo 2 |
| Nov 17, 2025 | 10 | Added SubagentStart | v2.0.43 | |
| Nov 10, 2025 | 9 | Added Notification | v2.0.37 | Demo 1 |
| Jul 28, 2025 | 8 | Added SessionStart | v1.0.62 | |
| Jul 16, 2025 | 7 | Added UserPromptSubmit | v1.0.54 | |
| Jul 10, 2025 | 6 | Added PreCompact | v1.0.48 | |
| Jul 2, 2025 | 5 | Split Stop into Stop and SubagentStop | v1.0.41 | |
| Jun 30, 2025 | 4 | Initial release: PreToolUse, PostToolUse, Stop, SessionEnd | v1.0.38 |
Not in Official Docs
Links
Other Repos
Codex CLIHooks
Gemini CLIHooks
Claude CodeBest Practice
Codex CLIBest Practice
Gemini CLIBest Practice
Developed by
| Workflow | Description |
|---|---|
| /workflows:workflow-changelog | Scan for new hooks and drift across all files |
| /workflows:workflow-add-hook * | Add any recommended hook across all files in one command |
Sponsor My Work
If you like my work, buy me a doodh patti 🍵 on
Polar