Claude Code Hooks

Claude Code mascot speaking

Mouse click on PreToolUse, Keyboard on PostToolUse, Human voice on other hooks

Demo Video + Presentation

How to Use

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.

If you don't follow the prerequisites, you will see the following error on claude code start

SessionStart:startup hook error

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

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

section divider

If you like my work, buy me a doodh patti 🍵 on