jtcressy-claude-plugins

Sound Hooks for Claude Code

A Claude Code plugin that plays audio notifications for all 18 hook events. Features a mix of novelty sound effects and voice lines — rubber ducky squeaks, Warcraft 3 peon voice lines ("Work work", "Something need doing?"), and other comedic audio cues. Each hook event has a distinct sound so you can tell what Claude is doing just by listening.

Sounds were generated with ElevenLabs TTS using the Samara X voice, mixed with various sound effects.

Installation

Add the marketplace to your ~/.claude/settings.json:

{
  "extraKnownMarketplaces": {
    "jtcressy-claude-plugins": {
      "source": {
        "source": "github",
        "repo": "jtcressy/claude-code-sound-hooks"
      },
      "autoUpdate": true
    }
  },
  "enabledPlugins": {
    "sound-hooks@jtcressy-claude-plugins": true
  }
}

Restart Claude Code. The plugin will be installed automatically.

To disable all sounds, set "sound-hooks@jtcressy-claude-plugins": false in enabledPlugins.

Supported Hook Events

#	Hook	Description	Sound
1	PreToolUse	Before tool calls	General tool sound
2	PermissionRequest	When permission is requested	Permission alert
3	PostToolUse	After tool calls complete	Completion sound
4	PostToolUseFailure	After tool calls fail	Error sound
5	UserPromptSubmit	When user submits a prompt	Input sound
6	Notification	When notifications are sent	Notification alert
7	Stop	When Claude finishes responding	Stop sound
8	SubagentStart	When subagent tasks start	Agent start sound
9	SubagentStop	When subagent tasks complete	Agent stop sound
10	PreCompact	Before compact operations	Compact warning
11	SessionStart	When a session starts/resumes	Session greeting
12	SessionEnd	When a session ends	Session farewell
13	Setup	When /setup runs	Setup sound
14	TeammateIdle	When a teammate agent idles	Idle alert
15	TaskCompleted	When a background task completes	Task done sound
16	ConfigChange	When config files change	Config change sound
17	WorktreeCreate	When worktrees are created	Worktree sound
18	WorktreeRemove	When worktrees are removed	Worktree sound

Special Sounds

• Git commit detection: When a Bash tool runs git commit, a special pretooluse-git-committing sound plays instead of the default PreToolUse sound.
• Agent-specific sounds: 6 agent hook events have distinct sounds in agent_* folders, used when the script is invoked from agent frontmatter with --agent=<name>.

Per-Hook Enable/Disable

Individual hooks can be toggled without disabling the entire plugin.

Configuration Files

File	Purpose	Committed
hooks/config/hooks-config.json	Default/shared config	Yes
hooks/config/hooks-config.local.json	Personal overrides	No (gitignored)

The local config takes precedence over the shared config.

Example: Disable noisy hooks

Create hooks/config/hooks-config.local.json in the plugin's cache directory:

{
  "disablePreToolUseHook": true,
  "disablePostToolUseHook": true,
  "disableLogging": true
}

All Config Keys

{
  "disableLogging": false,
  "disablePreToolUseHook": false,
  "disablePermissionRequestHook": false,
  "disablePostToolUseHook": false,
  "disablePostToolUseFailureHook": false,
  "disableUserPromptSubmitHook": false,
  "disableNotificationHook": false,
  "disableStopHook": false,
  "disableSubagentStartHook": false,
  "disableSubagentStopHook": false,
  "disablePreCompactHook": false,
  "disableSessionStartHook": false,
  "disableSessionEndHook": false,
  "disableSetupHook": false,
  "disableTeammateIdleHook": false,
  "disableTaskCompletedHook": false,
  "disableConfigChangeHook": false,
  "disableWorktreeCreateHook": false,
  "disableWorktreeRemoveHook": false
}

Prerequisites

• Python 3: Required for running the hook script (python3 --version to verify)
• Audio player (auto-detected):
  • Linux: paplay (PulseAudio), aplay (ALSA), ffplay, or mpg123
  • macOS: afplay (built-in)
  • Windows: winsound (built-in Python module)

Sound Files

Each hook event has a folder under hooks/sounds/ containing .mp3 and .wav variants: