Starcraft Sound Effects For Claude Code

🎮 StarCraft Sound Effects for Claude Code

**"Nuclear launch detected!"** - Transform your AI coding assistant into a StarCraft Terran Adjutant with semantic audio feedback.

Ever wished you could instantly *hear* what happened in Claude Code? Now you can. This system uses three StarCraft: Brood War Terran Adjutant audio channels: a 13-class semantic classifier, deterministic authorization prompts, and a once-per-session context-pressure alert.

🔊 What You'll Hear

A taste — the full 14-sound map lives in [The Sound Map](#the-sound-map):

You hear	It means
"Not enough minerals"	Claude needs information from you
"Insufficient vespene gas"	Your authorization is needed
"Nuclear missile ready"	Shipped — push, publish, deploy
"Nuclear launch detected"	Catastrophe — drop everything

Frequent sounds are calm; rare sounds are alarming. If you hear a sound you don't recognize, something unusual happened.

🚀 Quick Start

Prerequisites

1. Claude Code (Anthropic's official Claude desktop app)
2. macOS (uses afplay for audio - Linux/Windows support coming soon)
3. StarCraft sound files (see Getting Sounds section)
4. Anthropic API Key (Get one here)

Installation

1. Clone this repository:

git clone https://github.com/Elijas/starcraft-sound-effects-for-claude-code.git
cd starcraft-sound-effects-for-claude-code

1. Run the setup script:

./setup.sh

This will:

• Create your .env file from template
• Configure your API key
• Set up your sound directory path
• Test the API connection
• Update Claude Code settings

That's it! Restart Claude Code and you're ready to go.

Manual Setup

If you prefer manual configuration:

1. Copy the environment template:

cp .env.example .env

1. Edit .env with your settings:

ANTHROPIC_API_KEY=your-api-key-here
STARCRAFT_ROOT_DIR=/Users/your-u