📋 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/).
🐙 Meet the 19 Species
Every buddy is uniquely generated from your Claude Code account — same species, same stats, same personality every time. 19 species, each with 3 idle animation frames + a blink.
