@wyverselabs/claudecraft
v0.1.12
Published
CLI for installing StarCraft sounds into Claude Code hooks
Downloads
101
Readme
ClaudeCraft
CLI to install StarCraft sound effects into Claude Code hooks.
Interactive prompts are powered by Clack (@clack/prompts).
Demo
Run with npx
npx @wyverselabs/claudecraftExamples:
npx @wyverselabs/claudecraft install --scope project --preset expanded --race random
npx @wyverselabs/claudecraft doctor --scope projectLocal development
bun install
bun run build
node dist/cli.js install --scope project --preset expanded --race randomCommands
Install StarCraft sounds
npx @wyverselabs/claudecraft install
npx @wyverselabs/claudecraft install --scope project --preset expanded --race protoss --tool-cooldown 2 --yesFully interactive mode
npx @wyverselabs/claudecraftInteractive menu labels are outcome-focused (for example, Install StarCraft sounds).
Switch race/settings (no reinstall)
npx @wyverselabs/claudecraft switch --race zerg
npx @wyverselabs/claudecraft switch --race random --tool-cooldown 2 --failure-cooldown 20Uninstall hooks
npx @wyverselabs/claudecraft uninstall
npx @wyverselabs/claudecraft uninstall --scope global --yesDoctor
npx @wyverselabs/claudecraft doctor
npx @wyverselabs/claudecraft doctor --jsonRun tests
bun testRebuild tool sound pools (maintainers)
bun run curate:tool-soundsNotes
- Project scope writes
.claude/settings.local.jsonin the selected project. - Global scope writes
~/.claude/settings.json. --racesupportsprotoss,terran,zerg,random.PostToolUseFailurehook is installed in expanded mode (Bashmatcher).- Tool sounds (
PreToolUse,PostToolUse) use a 2s cooldown by default (override with--tool-cooldown). - Failure alerts use a 15s cooldown by default (override with
--failure-cooldown). - Failure noise filtering is on by default (disable with
--no-failure-filter). PreToolUseandPostToolUseuse race-specific sound pools for variety.all-sounds/is source/reference; active packaged sounds are copied intocurated-sounds/.- Sounds are auto-downloaded from GitHub on install when not present locally.
- You can override with
--sounds-dir /absolute/path/to/curated-sounds. - Existing non-ClaudeCraft hooks are preserved.
- Managed entries are tagged for safe uninstall.

