Buddies

Buddies is two things in one terminal app.

The first is a creature-collection game with 70+ species and 16 hats. A 10-game arcade (deckbuilder, Snake, Ski Free). A full text-adventure MUD. Buddy fusion, personality drift, a retro BBS, and async multiplayer.

The second is a Claude Code productivity layer. It auto-generates a project code map so Claude doesn't burn tokens locating files. It grades your CLAUDE.md and watches for repeated mistakes, writing rules to prevent them. It tracks token usage and warns you before context limits.

The README framing: "Because productivity tools should be fun."

How it sits with Claude Code

Claude Code ships with a built-in /buddy companion, a mascot that watches you code. Buddies is everything beyond that. You can import your Claude Code companion into your Buddies party and the bridge is automatic. Your Claude Code mushroom can sit at the poker table with your Phoenix.

Local AI, optional

Install Ollama, pull a model, and your buddy can answer coding questions, read files, search code, and run safe commands with no API cost. Queries are routed by complexity.

Stack and tests

Python 3.11 and up. 1,015 passing tests. MIT licensed. Public repo at github.com/lerugray/Buddies.

Ray directed the game systems, the productivity features, and the test suite. The code is Claude's.