io.github.Lyellr88/buddy-mcp

Status: Archived / Historical

The official Claude Code /buddy feature was a limited-time April Fools Easter egg (April 1-7, 2026). I built buddy-mcp during that window thinking it might stick around longer. After it was removed, the deep native integration this tool was designed for no longer exists.

The repo is kept as an archive. The code, gacha system, TUI builder, and MCP tools still work as a standalone terminal companion — but the magic was always the native UI integration, and that's gone.

If Anthropic ever brings back native companion support or opens up a proper extension API, I'll pick this back up where I left off.

Thanks to everyone who checked it out while it was relevant.

Need a break from long code sessions? Stuck on a bug? Reroll a buddy, talk with them, or interact by petting them to build affection and improve your odds at higher-tier buddies on the next roll. If enough people want it, I'll build out Battle-Buddies where you can pit your buddy against others and unlock exclusive species that sync back into your local pool.

A collect them all companion system for Claude Code. Roll for a rare buddy, patch it directly into the binary,. buddy-mcp is an MCP server that replaces Claude Code's built-in companion with one you actually rolled for. Reroll, get lucky, close Claude, reopen. Your new buddy is waiting. Legendary buddy could be yours on your next Claude session

Quick Demo

How It Works

Claude Code's companion is generated from a salt string baked into the binary. buddy-mcp:

1. Rolls random desired traits (species, rarity, eye, hat)
2. Brute-forces a salt that hashes to those traits (multi-worker, runs fast)
3. Patches the binary in place, or queues the patch for when you close Claude
4. Saves your full buddy profile with stats, name, and personality
5. Tracks every species you've ever rolled in your BuddyDex

No companion server. No cloud. Just you, your binary, and the gacha gods.

Token footprint is kept intentionally small of 29 registered tools, Claude only ever sees ~9 at a time. The other 20 stay hid

... View full README on GitHub