Your coding sessions
deserve a companion

buddy-evolution is a Claude Code plugin that turns every session into progress. Earn achievements, grow stats, track streaks, and build a journal of your development journey.

View on GitHub Install
claude — session
🐉 Zephyr welcomes you! Level 7 Elder ███████████████░░░░░ 35,200 / 50,000 XP Streak: 34 days (đŸ”Ĩ 2.0x) | Sessions: 87 Last session: +1,200 XP | 🏆 Test-Driven | Level 6 → 7 ... [you code for 2 hours] ... 🐉 Session complete! +840 XP Level 7 ██████████████████░░ 36,040 / 50,000 XP 🏆 The Architect — 20+ file edits (+500 XP)
// features

Everything runs locally.
Nothing leaves your machine.

🏆

34 Achievements

Across 6 categories — Coding, Testing, Debugging, Consistency, Exploration, and Meta. Including 2 hidden ones to discover.

📈

XP & Evolution

20 levels with evolution tiers. Choose your buddy's path at Level 5 and 10 — 4 final forms per species.

📓

Journal + Weekly Recaps

Automatic monthly logs with weekly summaries. Session recaps show in your next greeting.

🧠

Stat Growth

DEBUGGING, PATIENCE, CHAOS, WISDOM, SNARK — evolve from your activity patterns with diminishing returns.

📂

Project Tracking

Per-project XP and sessions. File familiarity: New → Familiar → Expert → Nostalgic.

🔔

Desktop Notifications

OS-native alerts when you unlock achievements. Linux and macOS supported.

// species

18 species. Same machine, same buddy.

Your companion is deterministically generated from your machine identity. You always get the same species, name, and personality.

đŸĻ†
Duck
Common
đŸĒŋ
Goose
Common
đŸĢ 
Blob
Common
🐌
Snail
Common
🐱
Cat
Uncommon
🐰
Rabbit
Uncommon
đŸĻ‰
Owl
Uncommon
🐧
Penguin
Uncommon
đŸĸ
Turtle
Rare
🐙
Octopus
Rare
đŸĻŽ
Axolotl
Rare
đŸ‘ģ
Ghost
Epic
🤖
Robot
Epic
🐉
Dragon
Epic
đŸĻĢ
Capybara
Legendary
🍄
Mushroom
Legendary
đŸŒĩ
Cactus
Legendary
đŸģ
Chonk
Legendary
// achievements

34 achievements to earn

First Steps
Complete first session
100 XP
Centurion
Complete 100 sessions
1,000 XP
Living Legend
Complete 1,000 sessions
10,000 XP
The Architect
20+ file edits in one session
500 XP
First Test
Run tests in a session
100 XP
Test Marathon
50+ test runs in one session
1,000 XP
Against All Odds
20+ rejected calls, still finish work
800 XP
Unbreakable
0 rejected in 50+ call session
500 XP
Streak: Week
7 consecutive days
500 XP
Streak: Month
30 consecutive days
2,000 XP
Streak: Year
365 consecutive days
20,000 XP
Marathon
Session longer than 4 hours
600 XP
Tourist
Work in 5 different projects
400 XP
Deep Roots
Expert on 5 files (50+ touches)
800 XP
Homecoming
Return to a file after 30+ days
200 XP
The Collector
Earn 20 different achievements
2,000 XP
🔒 Hidden
2 secret achievements to discover
??? XP
// install

Two commands. Zero setup.

# Run inside Claude Code: > /plugin marketplace add FrankFMY/buddy-evolution > /plugin install buddy-evolution@buddy-evolution # Restart Claude Code — your buddy appears on next session

No npm install. No build step. No configuration. No data leaves your machine.

// specification

Built from the community spec

This plugin implements the buddy-evolution specification — a collaborative design born from GitHub issues #41684 and #41867 in the Claude Code repository. The spec covers achievement-based progression, stat synergies, session journals, and file familiarity tracking.