StarCraft and Warcraft voice lines that play whenever Claude Code finishes work, asks for permission, or goes idle. 124 iconic lines from StarCraft Terran and Protoss units alongside Warcraft Human and Orc peons turn your coding sessions into a command center.

Uses Claude Code hooks to trigger sounds on three events:

• Stop — Claude finishes a task
• Notification (permission_prompt) — Claude needs your approval
• Notification (idle_prompt) — Claude is waiting for input

git clone https://github.com/danavramescu/claude-code-taunts.git
cd claude-code-taunts
./install.sh

That's it. Start a Claude Code session and you'll hear voice lines.

The installer:

1. Copies 124 sound files to ~/.claude/sounds/
2. Installs play-sound.sh and toggle-sounds.sh to ~/.claude/
3. Merges hook entries into ~/.claude/settings.json (backs up existing file first)
4. Plays a test sound to confirm everything works

Your existing Claude Code settings are always preserved.

• Claude Code installed (~/.claude/ must exist)
• python3 (for safe JSON merging during install)
• macOS: No extra dependencies — uses built-in afplay
• Linux: One of these audio players:
  • paplay (PulseAudio — most common)
  • mpv
  • ffplay (comes with FFmpeg)
  • aplay (ALSA)

cd claude-code-taunts
git pull
./install.sh

The installer is idempotent — it won't duplicate hooks or overwrite your toggle state. It will update the scripts and copy any new sound files.

cd claude-code-taunts
./uninstall.sh

The uninstaller only removes what this repo installed:

• Deletes the repo's sound files from ~/.claude/sounds/ (your custom sounds are kept)
• Removes play-sound.sh, toggle-sounds.sh, and sounds-enabled
• Removes only the play-sound.sh hook entries from settings.json (all other settings preserved)
• Cleans up the lock file at /tmp/claude-sound-lock

# Toggle
~/.claude/toggle-sounds.sh

# Explicit
~/.claude/toggle-sounds.sh off
~/.claude/toggle-sounds.sh on

Drop any .mp3, .wav, .aiff, or .m4a file into ~/.claude/sounds/ and it will be included in the random rotation. No restart needed.

Claude Code hook event
  → ~/.claude/play-sound.sh
    → checks toggle (sounds-enabled)
    → checks lock file (5s cooldown to prevent double sounds)
    → picks random file from ~/.claude/sounds/
    → plays in background (non-blocking)

The install script merges hook configuration into ~/.claude/settings.json using Python's json module, so your existing settings are always preserved.

124 voice lines from StarCraft and Warcraft:

No sound plays

• Check sounds are enabled: cat ~/.claude/sounds-enabled (should say on)
• Verify files exist: ls ~/.claude/sounds/
• Test manually: ~/.claude/play-sound.sh
• On Linux, verify an audio player is installed: which paplay mpv ffplay aplay

Double sounds / overlapping

• The lock file at /tmp/claude-sound-lock prevents sounds within 5 seconds of each other
• If stuck, remove it: rm /tmp/claude-sound-lock

Hooks not triggering

• Check ~/.claude/settings.json has the hook entries (look for play-sound.sh under hooks)
• Re-run ./install.sh to re-merge hooks

Install script fails on settings.json

• Ensure python3 is available
• Check if ~/.claude/settings.json is valid JSON: python3 -m json.tool ~/.claude/settings.json
• A backup is saved as ~/.claude/settings.json.backup during install

The audio files in this repository are voice lines from StarCraft and Warcraft, which are the intellectual property of Blizzard Entertainment. They are included for personal, non-commercial use only. This project is not affiliated with or endorsed by Blizzard Entertainment. The MIT license applies only to the code (scripts and configuration), not the audio files.