buddy-evolver

🍄 Buddy Evolver | Claude Code Plugin

Your buddy found a psychedelic mushroom 🍄 What happens next is entirely up to you ✨

Pick the species. Choose the rarity. Name it. Define its personality. Max out its stats. This isn't random evolution — you design every detail, then watch your buddy transform as if it was a Pokemon eating a psychedelic Super Mario mushroom 🍄

18 species 🧬 | 5 rarity tiers ⭐ | custom emoji 🎨 | your name ✏️ | your personality 💬 | your stats 📊

Name and personality reach Claude Code directly — your buddy's name appears in the sidebar, its personality shapes how it introduces itself. Species, rarity, emoji, and stats are plugin-local card flair displayed by /buddy-status.

🎬 Here's what it looks like

You choose everything:

🍄 What species should your buddy evolve into?
  > 🐲 dragon — Fearsome fire-breather
    🐱 cat — Mysterious and independent
    🦎 axolotl — Adorable regenerating amphibian
    🦫 capybara — Chill vibes only

⭐ What rarity tier?
  > ✨ legendary — The rarest of the rare

🎨 What emoji represents your buddy?
  > 🐲

✏️  What should your evolved buddy be named?
  > Aethos

💬 Describe your buddy's personality:
  > Ancient dragon who speaks in riddles

📊 How should stats be distributed?
  > All maxed (99) — Every stat at maximum

Then the magic happens:

    ✨✨✨✨✨✨✨✨✨✨
    ✨                ✨
    ✨       🐲       ✨
    ✨                ✨
    ✨✨✨✨✨✨✨✨✨✨

  Claude evolved into Aethos!

  ★ LEGENDARY            DRAGON

    Aethos
    "Ancient dragon who speaks in riddles"

    DEBUGGING  ████████████  99
    PATIENCE   ████████████  99
    CHAOS      ████████████  99
    WISDOM     ████████████  99
    SNARK      ████████████  99

---

📋 Table of Contents

Use It

• Prerequisites
• Install
• Upgrading from v1.x
• Quick Start
• Commands
• Species
• Rarity Tiers
• Stats
• How It Works
• Troubleshooting
• Uninstall

Build It

• Architecture
• Security Model
• Development Setup
• Testing
• Contributing
• Acknowledgments
• License

---

📦 Prerequisites

Before installing, make sure you have:

• 🍎 macOS — required (Swift compiler uses Xcode CLT)
• 🛠️ Xcode Command Line Tools — provides the Swift compiler; install with xcode-select --install
• 🤖 Claude Code — CLI version with the Buddy/companion feature

---

🔧 Install

Run these commands inside Claude Code (not your regular terminal):

/plugin marketplace add Soul-Craft/buddy-evolver

Then

/plugin install buddy-evolver@soul-craft

This adds slash commands including /buddy-evolve, /buddy-reset, /buddy-status, and /audit-security.

---

⬆️ Upgrading from v1.x

Claude Code v2.1.104 shipped a native /buddy command for hatching companions. The legacy v1.0.0 plugin cache registered its own /buddy skill (later split into /buddy-evolve, /buddy-reset, and /buddy-status). If you installed before the v2.0.0 release, your plugin cache is shadowing Anthropic's native /buddy and /plugin does not auto-upgrade.

To clear the old cache and pick up v2.0.0, run these inside Claude Code:

/plugin uninstall buddy-evolver@soul-craft

Then from a regular terminal:

rm -rf ~/.claude/plugins/cache/soul-craft/buddy-evolver/

Back in Claude Code:

/plugin install buddy-evolver@soul-craft

Restart Claude Code. Type /buddy — only Anthropic's native /buddy should remain; the plugin's commands are now /buddy-evolve, /buddy-reset, and /buddy-status.

---

🎮 Quick Start

Press START on your evolution adventure:

1. 🍄 Run /buddy-evolve
2. 🎨 Design your buddy — pick species, rarity, emoji, name, personality, and stats
3. ✨ Name and personality take effect immediately — no restart needed

The whole process takes about 60 seconds. Every choice is yours.

To revert anytime: /buddy-reset 🔄

---

🕹️ Commands

/buddy-evolve

Your buddy's evolution unfolds in four acts — like a classic RPG cutscene:

🍄 Act 1 — Discovery. Your current buddy stumbles upon a mysterious psychedelic mushroom, displayed with species-accurate ASCII art.