claudefx 🎮

Retro game sounds and themed spinner verbs for Claude Code. Plays nostalgic sound effects from StarCraft, Warcraft, Mortal Kombat, and Age of Empires 2 when Claude finishes a response, starts a session, sends a notification, and more. Also replaces Claude's thinking spinner with game-themed phrases.

Works on macOS, Windows, and Linux.

Installation

npx claudefx

That's it. Pick a theme from the menu — hooks are set up automatically using npx, no global install needed.

Available Themes

| Theme | Game | |-------|------| | sc-terran | 🚀 StarCraft: Terran | | sc-protoss | ⚡ StarCraft: Protoss | | wc-orc | 👹 Warcraft: Orc | | wc-human | 🛡️ Warcraft: Human | | mk | 🕺 Mortal Kombat | | ao2-britons | 🏹 Age of Empires 2: Britons | | ao2-franks | ⚜️ Age of Empires 2: Franks | | ao2-turks | 💣 Age of Empires 2: Turks |

Usage Stats in the Status Bar

Each theme displays a live status line at the bottom of your terminal showing two game-themed metrics:

• Token count — total input tokens spent in the session, displayed at 1/10th scale (e.g. 3,500 tokens → 350) with a theme-appropriate icon (💰 for Warcraft and Age of Empires, 💎 for StarCraft)
• Rate limit — your 5-hour usage quota percentage, shown as a thematic indicator: construction progress for Warcraft, nuclear readiness for StarCraft: Terran, Mothership energy for StarCraft: Protoss, castle fortification for Age of Empires, or a health bar for Mortal Kombat

The status line updates automatically after each Claude response. Rate limit stats are available for Claude Pro and Max subscribers only — the token count is shown for everyone.

Themed Spinner Verbs

Each theme also replaces Claude Code's spinner verbs with game-themed phrases. While Claude is thinking, you'll see lines like "Spawning zerglings" or "Summoning ogres" instead of the defaults.

Usage

Interactive menu

npx claudefx

Use ↑↓ to navigate, ←→ to adjust volume, Enter to select, q to quit.

CLI commands

npx claudefx list              # list all themes
npx claudefx use <theme>       # apply a theme
npx claudefx use ao2-turks     # example
npx claudefx off               # disable sounds
npx claudefx current           # show active theme
npx claudefx uninstall         # remove hooks, verbs, and uninstall package
npx claudefx volume <0-100>    # set volume (e.g. claudefx volume 60)

How It Works

claudefx use <theme> writes hooks and spinner verbs to ~/.claude/settings.json. Claude Code triggers sounds on these events:

| Event | When | |-------|------| | sessionstart | A session begins | | stop | Claude finishes a response | | question | Claude sends a notification | | sessionend | A session ends | | submit | You send a message |

Requirements

• Node.js 18+
• Claude Code
• macOS: built-in afplay (no extra deps)
• Windows: built-in PowerShell (no extra deps)
• Linux: mpg123 (sudo apt install mpg123)

Uninstall

npx claudefx uninstall

Removes all hooks and spinner verbs from ~/.claude/settings.json, uninstalls the package, and deletes all sound files.

Contributors

• Mert Sişmanoğlu — dependency checks for audio tools

Contributions are welcome! Feel free to open a pull request.

See Also

claude-verbs — replace Claude Code's thinking verbs with Star Wars, Game of Thrones, Lord of the Rings, Project Hail Mary, and more. Highly recommended, give it a try!

License

MIT © Samet Acar

Disclaimer

This is an unofficial fan project, free for personal and non-commercial use. It is not affiliated with, endorsed by, or sponsored by Blizzard Entertainment, Midway Games, Microsoft, or any other game publisher or rights holder. All sound clips remain the property of their respective owners. All trademarks and registered trademarks are the property of their respective owners.

If you are a rights holder and would like any content removed, please open an issue and it will be taken down promptly.