dancing-claude
v0.1.1
Published
Your terminal mascot, dancing through every tool call. Animates the Claude Code mascot in your statusline.
Downloads
245
Maintainers
Readme
dancing-claude
npx dancing-claude installYour terminal mascot, dancing through every tool call. Not affiliated with Anthropic.
A Claude Code plugin that animates the mascot character in your terminal statusline. The character reacts to what Claude is actually doing — different pose per tool call.
♪ ▐▛███▜▌ ~ $_ Bash dancing-claude · sigmashake.com/bop
♫ ▐▛███▜▌ ≈ ✎ Edit dancing-claude · sigmashake.com/bop
✦ ▐▛███▜▌ ∿ ▤ Read dancing-claude · sigmashake.com/bop
★ ▐▛███▜▌ ⌇ ☁ WebFetch dancing-claude · sigmashake.com/bopZero dependencies. Pure JS. Installs with one command. Uninstalls cleanly.
Install
npx dancing-claude installThis adds a statusLine and 5 hooks to ~/.claude/settings.json. Your existing
settings are preserved. A backup is written to ~/.claude/settings.json.dancing-claude.bak.
Preview before installing:
npx dancing-claude demoUninstall any time:
npx dancing-claude uninstallHow it works
Claude Code's statusLine command runs once per turn. Between turns, Claude Code fires
PreToolUse / PostToolUse hooks on every tool call. dancing-claude uses those hooks
to advance a frame counter and capture the current tool name — then the statusline command
reads the state and renders the matching pose.
No daemon. No background process. No network calls.
State lives in ~/.claude/dancing-claude/state.json.
Per-tool poses (12+ tools)
| Tool | Badge |
|------|-------|
| Bash | $_ |
| Edit | ✎ |
| Write | ⊞ |
| Read | ▤ |
| Glob | ◎ |
| Grep | ⌕ |
| WebFetch | ☁ |
| WebSearch | ⚲ |
| Agent | ⊕ |
| TodoWrite | ✓ |
| MCP tools | ⇌ |
Commands
dancing-claude # print one statusline frame (used by Claude Code)
dancing-claude install # install into ~/.claude/settings.json
dancing-claude install --dry-run # preview changes before applying
dancing-claude uninstall # remove from settings.json
dancing-claude demo # animated preview (record this for your viral video)
dancing-claude doctor # verify install status
dancing-claude config set watermark off # hide the sigmashake.com/bop watermarkTerminal compatibility
Tested and working:
| Terminal | Status |
|----------|--------|
| iTerm2 (macOS) | ✓ full color |
| Alacritty | ✓ full color |
| Windows Terminal | ✓ full color |
| VS Code integrated | ✓ full color |
| tmux | ✓ full color (pass-through) |
| screen | ✓ full color |
| GitHub Codespaces | ✓ full color |
| No TERM or COLORTERM | → plain ASCII fallback |
Watermark
The default statusline includes dancing-claude · sigmashake.com/bop. You can opt out:
dancing-claude config set watermark offGlobal install (optional)
npm install -g dancing-claudeMade by SigmaShake
sigmashake.com — Claude Code governance tools.
If you're using dancing-claude, check out @sigmashake/ssg — deterministic rules that block destructive agent commands before they run.
MIT License
