@wyverselabs/claudecraft
v0.1.11
Published
CLI for installing StarCraft sounds into Claude Code hooks
Readme
claudecraft
CLI to install StarCraft sound effects into Claude Code hooks.
Interactive prompts are powered by Clack (@clack/prompts).
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.
