PurrCode

Claude works. Claude purrs.

PurrCode is an open-source Claude Code addon that plays a continuous cat-purring sound while Claude is processing a turn. When you submit a prompt, the purr fades in; when the turn ends (or fails, or the session closes), it fades out.

Install

Requires Node.js 20+ and Claude Code on your PATH.

npm install -g purr-code
purrcode install

This registers PurrCode as a Claude Code plugin. Your settings.json hooks are never edited on the default path.

Then restart Claude Code (or start a new session) so the purr hooks load.

Prefer no global install? npx purr-code install works too — but then prefix every later command with npx as well (npx purr-code preview): npx runs from its cache and puts no purrcode command on your PATH.

Then try:

purrcode preview
purrcode volume 30

CLI

| Command | Purpose | | --- | --- | | purrcode install / uninstall | Plugin register / clean removal | | purrcode on / off | Enable or mute | | purrcode status | Daemon + backend snapshot | | purrcode volume <0-100> | Perceptual volume | | purrcode preview [name] | ~10 s sample (no Claude session needed) | | purrcode doctor | Diagnostics |

Privacy

• No network requests at runtime. No telemetry, analytics, or update checks.
• No prompt or transcript access. Hooks never read, store, or log prompt text, responses, tool inputs, or repository contents.
• Failures are silent on the hook path (exit 0, zero stdout/stderr) so Claude's transcript stays clean.

Docs, issues, contributing

Full documentation, troubleshooting, and contribution guides live in the GitHub repository.

License

MIT. Bundled audio provenance: ASSETS.md.