good-buddy

Good Buddy — Free Gamification for Your Claude Code Buddy

A lightweight Claude Code plugin that upgrades Anthropic's /buddy companion with XP, levels, achievements, and streaks. No API calls. No extra cost. Just code and level up.

---

Install

claude plugin marketplace add VersoXBT/good-buddy
claude plugin install good-buddy

Restart Claude Code. Your buddy starts earning XP immediately.

Why Good Buddy?

Anthropic's built-in /buddy gives you a cute ASCII companion — but it doesn't do anything. No progression, no rewards, no reason to come back.

Good Buddy fixes that. It hooks into Claude Code's tool events and silently tracks everything you do. Edits, tests, commits, debug sessions — each one earns XP. Your buddy levels up, unlocks achievements, builds coding streaks, and even has a mood that reacts to how your session is going.

What it costs: Nothing. The plugin runs pure Node.js scripts locally in under 50ms per event. No API calls, no tokens consumed, no network requests. Your data stays on your machine in a single JSON file.

Commands

/xp              Level, XP bar, streak multiplier, mood
/achievements    All 15 achievements with unlock progress
/streak          Daily coding streak with weekly calendar
/buddy-stats     Full dashboard with XP breakdown and top tools

/xp Output

╔═══════════════════════════════════════╗
║  Level 9 — Architect                  ║
║                                       ║
║  XP: 5,240 / 7,628                    ║
║  [████████████░░░░░░░░]  68%          ║
║                                       ║
║  Streak: 5 days (1.25x multiplier)    ║
║  Mood: focused                        ║
╚═══════════════════════════════════════╝

How XP Works

Every coding action earns XP automatically through Claude Code hooks:

Action	XP	Example
Edit a file	+5	Refactoring a function
Create a file	+8	Adding a new module
Run tests	+15	npm test, pytest, cargo test
Tests pass	+5 bonus	Green test suite
Build	+10	npm run build, tsc, make
Git commit	+12	Committing your work
Git push	+8	Pushing to remote
Create PR	+25	gh pr create
Fix a bug	+20	Edit right after a failed command

Code daily to build a streak multiplier: 3+ days = 1.25x, 7+ = 1.5x, 14+ = 1.75x, 30+ = 2.5x.

20 Levels

Progress from Hatchling to Ascended. Milestone levels unlock cosmetic border styles.

Level	Title	XP	Unlock
1	Hatchling	0	Basic
4	Code Cadet	487	Dot border
8	Craftsman	3,279	Double border
10	Senior Dev	7,628	Star border
15	Fellow	59,249	Flame border
20	Ascended	451,244	Rainbow

All 20 levels

Level	Title	XP Required
1	Hatchling	0
2	Apprentice	100
3	Junior Dev	250
4	Code Cadet	487
5	Script Kiddo	831
6	Debugger	1,346
7	Builder	2,119
8	Craftsman	3,279
9	Architect	5,019
10	Senior Dev	7,628
11	Lead Engineer	11,543
12	Staff Engineer	17,414
13	Principal	26,222
14	Distinguished	39,433
15	Fellow	59,249
16	Sage	88,974
17	Legendary	133,561
18	Mythic	200,442
19	Transcendent	300,763
20	Ascended	451,244

15 Achievements

Each achievement awards bonus XP and shows a celebration banner in your terminal.

Achievement	How to Unlock	Bonus
First Blood	First edit	+50
Bug Squasher	Fix 10 bugs	+100
Test Addict	Run 50 test suites	+150
Streak Master	14-day streak	+200
Polyglot	Edit 5+ languages	+100
Git Guru	25 commits	+100
Master Architect	Reach Level 10	+250
Ascension	Reach Level 20	+500

All 15 achievements