Buddy FAQs

Question 1

What kind of interactions can I have with my Buddy?

Accepted Answer

You can 'talk to' your buddy, 'pet' them, and view your 'BuddyDex' to track collected species. Buddy also offers natural language command activation, so you can simply chat with Claude Code (e.g., 'reroll buddy' or 'pet them') to trigger companion interactions.

Question 2

What is Buddy and how does it enhance Claude Code?

Accepted Answer

Buddy integrates a gacha-style collectible AI companion system directly into Claude Code's binary. It allows developers to roll for, customize, and interact with unique AI companions, providing a fun break and personalized experience during coding sessions.

Question 3

How does Buddy integrate with Claude Code's existing system?

Accepted Answer

Buddy directly patches Claude Code's binary, replacing its built-in companion with one you've rolled or created. It operates locally, with no external companion servers or cloud dependencies, ensuring privacy and direct integration.

Question 4

Can I customize my AI companion with Buddy?

Accepted Answer

Yes! Buddy features an interactive TUI (Terminal User Interface) builder (`buddy-mcp-build`) that lets you precisely craft your perfect companion. You can pick species, rarity, eyes, and hats, then brute-force a matching salt and patch it directly into Claude Code.

Question 5

How does the gacha and affection system work?

Accepted Answer

Every 'reroll' is a random pull for a new companion with unique species, rarity, stats, and personality. You can 'pet' your buddy to build affection tokens. Spend a token on your next reroll to guarantee a rare+ rarity, significantly improving your chances for epic and legendary buddies.

Buddy

Buddy

Key Features

Use Cases

Key Features

Use Cases