claudecode-sounds

"Your sound card works perfectly."

The spirits of Azeroth now herald your coding endeavors. When Claude Code requires your counsel, the ancient sounds of Warcraft III shall summon you back to the battlefield of code.

The Call to Arms

• Question Sound — "My liege?" — Claude seeks your wisdom
• Complete Sound — "Job's done!" — Your task stands victorious
• Error Sound — "That was a mistake." — Dark forces have intervened
• Permission Sound — "Are you sure?" — Authorization required, Commander

Available Soundpacks

Soundpack	Description
warcraft3-en	Warcraft 3 (English) — default
warcraft3-ru	Warcraft 3 (Русский)

Summoning the Plugin

From the Marketplace (Recommended)

# Add the marketplace
/plugin marketplace add newink/codingagents

# Summon the plugin
/plugin install claudecode-sounds@codingagents

Important: Restart Claude Code after installation for the sounds to take effect.

Manual Summoning

# Channel the plugin directly
claude --plugin-dir /path/to/claudecode-sounds

Or bind it to your project stronghold:

cp -r claudecode-sounds /your/project/.claude-plugin/

Important: Restart Claude Code after installation for the sounds to take effect.

Battle Commands

Command	Effect
/claudecode-sounds:test-sounds	Display current soundpack and test the war horns
/claudecode-sounds:soundpack-set <name>	Switch soundpacks (e.g., /claudecode-sounds:soundpack-set warcraft3-ru)
/claudecode-sounds:soundpack-create	Forge a new custom soundpack

Configuration Scroll

Your settings are inscribed in .claude/claudecode-sounds.json:

{
  "soundpack": "warcraft3-en"
}

Forging Custom Soundpacks

Craft your own legendary soundpack:

1. Create a new stronghold in soundpacks/ with your pack name
2. Arm it with these sound files (WAV format):
   • question.wav — The call for guidance
   • complete.wav — The victory fanfare
   • error.wav — The cry of defeat
   • permission.wav — The request for authority
3. Inscribe the soundpack.json manifest:

   {
     "name": "My Legendary Soundpack",
     "description": "Sounds forged in the fires of Mount Hyjal",
     "sounds": {
       "question": "question.wav",
       "complete": "complete.wav",
       "error": "error.wav",
       "permission": "permission.wav"
     }
   }

System Requirements

Claude Code’s npm installation currently requires Node.js 18+. Claude Code also has native installer paths that do not rely on npm. This plugin can play sounds through Node.js or Python 3, and it tries Node.js first, then falls back to Python automatically.

If using the Claude Code native installer without Node.js or Python, install one for sound support.

macOS

The native afplay command is used. No additional artifacts required.

Linux

One of these audio conduits: paplay (PulseAudio), aplay (ALSA), mpv, or ffplay

Windows

Claude Code supports Windows through WSL and native Windows install paths. Bash-based Claude Code workflows on Windows use Git Bash. This plugin includes both:

• scripts/run-cli.sh for Bash-based environments such as macOS, Linux, WSL, and native Windows with Git Bash
• scripts/run-cli.ps1 for native PowerShell usage

Audio playback uses PowerShell audio on the Node.js path or the built-in winsound module on the Python path.

---

"What is it now?"

License

Sound files from Warcraft 3 are property of Blizzard Entertainment. For the Horde! (And the Alliance, we suppose.)