claude-audio-hooks

Claude Audio Hooks

Game voice-line sound packs for Claude Code event hooks. Plays a random line when a session starts, a task finishes, Claude asks for permission, or a command errors out — pulled from three franchises, switchable on a single symlink.

StarCraft 2 · Halo · Tiberian Sun — 8 packs, ~330 cleaned clips.
*"Battlecruiser operational."* — every time you start a session

Install

One-liner (no clone needed):

Or from the repo:

Every pack installs; the installer just asks which one to start with. Begin a new Claude Code session and you'll hear it. Switch any time with set-faction.sh.

What It Does

Uses Claude Code hooks to trigger sounds on four events:

Error sounds are smart-filtered — they only fire on genuinely interesting failures (build errors, test failures, git conflicts, crashes, permission issues). Routine noise like grep no-match or which not-found is silenced, and a 15-second cooldown prevents rapid-fire.

The mechanism is pack-agnostic: every pack is a folder of four event buckets (session-start, task-complete, needs-permission, error), and play-random.sh picks a random clip from the active pack's bucket. The active symlink decides which pack plays.

The Packs

StarCraft 2 — full sound lists

Terran (28)
Session start: Battlecruiser operational · Goliath online · Marine ready · Raven online · Siege tank ready
Task complete: Add-on complete · Ghost reporting · Job confirmed · Job's finished · Research complete · Salvage complete · Upgrade complete
Needs permission: Base under attack · Calldown launch · Forces under attack · Go ahead TacCom · Incoming orders · Nuclear strike · Nuke ready · Say the word · Standing by · What's your call?
Error: Build error · Construction interrupted · Need more gas · Need more supply · Not enough energy · Not enough…