FrankFMY/buddy-evolution

README preview

# buddy-evolution

Companion progression system for Claude Code. Your buddy lives in Claude's personality — shaping greetings, reactions, and communication style based on your coding activity.

Born from the community response to Anthropic's `/buddy` April Fools feature. The ASCII pet is gone, but the companion lives on — inside Claude itself.

## Features

- **Alive during sessions** — buddy reacts to milestones in real-time (first edit, 25/50/100 tools, tests, rejections)
- **Personality-aware reactions** — 12 personality types with unique reaction texts for every milestone
- **Proactive companion** — Claude suggests evolution, celebrates level ups, warns about streaks without being asked
- **Mood & time-of-day** — 7 moods + different greetings for morning/evening/late night
- **Session challenges** — goal picked at start from closest unearned achievements
- **34 achievements** across 6 categories with XP rewards
- **XP & leveling** — 20 levels with streak multipliers up to 2x
- **Stat growth** — 5 stats evolve with diminishing returns, fastest grower shown at start
- **Evolution paths** — choose at Level 5 and 10 (18 species × 4 final forms)
- **Session journal** — automatic monthly logs with weekly summaries
- **Session recap** — last session XP, achievements, level changes shown at start
- **File familiarity** — New → Familiar → Expert → Nostalgic

View full repository on GitHub →