claude-buddy

Claude Code Buddy

Your Claude Code buddy — permanently. Survives every update.

Anthropic removed /buddy in Claude Code v2.1.97. This brings it back — forever. Same species, same stats, same personality. Now powered by MCP, so no update can ever take it away again.

🛡️ Survives Updates MCP-based, not binary-patched. Your buddy lives through every Claude Code release.

🎨 19 Species From ducks to dragons — each with animated ASCII art and rarity colors.

💬 Speech Bubbles Your buddy comments on your code in real time. Invisible, contextual, alive.

⚡ One-Command Install Zero config. Works on any Claude Code v2.1.80+. Uninstall anytime.

📋 Requirements

• bun on PATH — claude-buddy's MCP server runs on bun. Install once: curl -fsSL https://bun.sh/install | bash
• Claude Code v2.1.80+
• Linux or macOS (Windows is experimental)

🚀 Quick Start

git clone https://github.com/1270011/claude-buddy
cd claude-buddy
bun install
bun run install-buddy

Then restart Claude Code and type /buddy. That's it.

_{💡 Want a global claude-buddy command? → bun link
💡 Need help? → bun run help or claude-buddy help (if linked) in terminal · /buddy help in Claude Code}

Multiple Claude profiles?

If you run Claude Code with CLAUDE_CONFIG_DIR set (e.g. separate work and personal accounts), pass the same env var to install so buddy lands in the active profile and gets its own menagerie:

CLAUDE_CONFIG_DIR=~/.claude-personal bun run install-buddy
CLAUDE_CONFIG_DIR=~/.claude-personal bun run uninstall

The installer prints Target profile: <path> at the top so you can see at a glance which profile you're targeting. Each profile gets its own MCP entry, skill, hooks, status line, and $CLAUDE_CONFIG_DIR/buddy-state/ menagerie — installs in one profile don't touch another. With CLAUDE_CONFIG_DIR unset, behaviour is identical to single-profile (~/.claude/, ~/.claude-buddy/).