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.

💎

Alive During Sessions

Real-time reactions to milestones — first edit, 50th tool call, test runs, rejection streaks. 12 personality types with unique voice.

🏆

34 Achievements

6 categories, 2 hidden. Session challenges picked at start. Proactive evolution suggestions at Level 5 and 10.

📈

XP & Evolution

20 levels, streak multipliers. Choose evolution paths — 4 final forms per species. Time-of-day greetings.

🧠

Personality & Mood

12 personalities shape how Claude communicates. 7 moods shift with streak, achievements, and level. Bold talks different than gentle.

📂

Project Tracking

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

ðŸŽĻ

Full Customization

Change species, personality, name, and stats anytime. 12 personalities shape Claude's communication style.

// species

18 species. Your choice.

Randomly assigned at creation, or fully customizable — change species, personality, name, and stats anytime with /buddy-evolution:customize.

ðŸĶ†
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.