Your /buddy pet sits there looking cute. Nothing changes. That's boring.
buddy-rpg turns your terminal companion into a living RPG character. Every command you run, every file you edit, every bug you rage-quit and come back to — it all counts. Your buddy levels up, unlocks achievements, fights monsters, and develops a personality that reflects your coding habits.
npx buddy-rpgFirst run: paste your /buddy card output. That's it. Hooks do the rest.
buddy-rpg status # your pet card — the good stuff
buddy-rpg feed # throw some bytes into the void
buddy-rpg pet # your buddy needs this more than you think
buddy-rpg battle # fight things. gain XP. feel alive.
buddy-rpg achievements # 15 milestones, none of them easy
buddy-rpg season # seasonal rank & prestige
buddy-rpg history # growth log
buddy-rpg reset # nuclear option
Your buddy earns XP by watching you code. Not by doing anything heroic — just by existing while you type.
| You do | Buddy gets | Why |
|---|---|---|
| Edit/write code | +5 XP, DEBUGGING +1 | You're fixing things |
| Run commands | +3 XP, WISDOM +1 | You're figuring things out |
| Read/search code | +2 XP, WISDOM +1 | You're learning things |
| Break stuff | +2 XP, PATIENCE +1 | Failure is a teacher |
| Debug breakthrough (3+ failures then success) | +25 XP, DEBUG +3, PATIENCE +2 | The real boss fight |
| 30min+ session | +20 XP, PATIENCE +3 | Commitment |
| 60min+ session | +50 XP, PATIENCE +5 | Dedication |
| 3+ sessions/day | +10 XP, CHAOS +2 | You're unhinged and we love it |
| Daily streak | multiplier | Compounding gains |
| Level | XP needed | Min days | Stat cap |
|---|---|---|---|
| Hatchling | 0 | 0 | 40 |
| Juvenile | 500 | 3 | 55 |
| Adult | 5,000 | 14 | 75 |
| Elder | 50,000 | 45 | 90 |
| Mythic | 200,000 | 90 | 99 |
You need both enough XP and enough calendar days. Can't grind your way to Mythic in a weekend. (Well, you literally can't — the system won't let you.)
15 of them. Some are milestones. Some are personality tests.
- Bug Whisperer — DEBUGGING hits 30. You've seen things.
- Agent of Chaos — CHAOS hits 80. Unpredictable. Unstoppable. Concerning.
- Zen Master — PATIENCE hits 60. How are you this calm?
- Night Owl — 10 sessions after 10pm. Sleep is optional.
- The Comeback — 5 debug breakthroughs. You refuse to give up.
- Arena Fighter — Win 5 battles. Violence was the answer.
buddy-rpg battle pits your pet against creatures. Win rates depend on your stats — high DEBUGGING and WISDOM help, but CHAOS keeps things spicy. Lose and your buddy loses some dignity (and a bit of XP). Win and you climb the ranks.
Everything lives in ~/.buddy-rpg.json. Nothing leaves your machine. Zero npm packages. The entire thing runs on Node.js built-ins.
- Node.js 18+
- Claude Code with a Pro/Max subscription
- A hatched buddy (
/buddyin Claude Code)
MIT