claude-pet-companion 2.2.1

A 3D virtual pet plugin for Claude Code with 10 evolution stages and 5 paths

Claude Pet Companion

A beautiful animated desktop pet that lives on your screen while you code with Claude Code.

---

What's New in v2.2

3D Evolution System

• 10 Evolution Stages - From Egg to Ancient with unique visual appearances
• 5 Evolution Paths - Coder, Warrior, Social, Night Owl, Balanced
• 3D Pseudo-Rendering - Multi-layer depth simulation with dynamic lighting
• Evolution Items - Collect special items to trigger evolutions
• 100+ Accessories - Path-specific items unlocked at each stage
• Time-Based Lighting - Dynamic ambient lighting that changes throughout the day
• Memory System - Pet remembers your coding activities and patterns

---

Features

Evolution System

10 Stages: Egg → Hatchling → Baby → Child → Pre-Teen → Teen → Young Adult → Adult → Elder → Ancient

5 Paths:

Path	Style	Special Features
Coder	Tech	Blue/Green, pixel eyes, binary particles
Warrior	Battle	Orange/Red, sharp eyes, flame aura
Social	Cute	Pink/Heart, round body, heart particles
Night Owl	Mystery	Purple/Yellow, glowing eyes, stardust trail
Balanced	Harmony	Green/Teal, gentle eyes, nature aura

Evolution Items:

Item	Use	How to Get
Code Fragment	Stages 1-3	Create 5 files
Bug Slayer	Stages 4-6	Fix 10 errors
Wisdom Crystal	Stages 7-8	90%+ productivity
Ancient Relic	Stage 9	All achievements
Friendship Badge	Social boost	50 interactions
Moonstone	Night Owl boost	10hrs night coding

Theme System

Switch between 5 color schemes via right-click menu:

• Blue (Default) - Classic Claude blue tones
• Pink - Warm rose and magenta
• Green - Fresh nature greens
• Dark - Sleek monochrome
• Purple - Mystical violet vibes

Productivity Tracking

The pet monitors your Claude Code activity:

Metric	Description
Productivity Score	Based on success rate and activity frequency
Focus Score	Measures continuous work time vs breaks
Combo/Streak	Bonus XP for rapid consecutive actions
Flow State	Special effects when focus >= 80%

Dynamic Expressions

State	Expression
Idle	😊 Happy with smile
Thinking	🤔 Eyes shift with question mark
Working	⚡ Focused with sweat drop
Error	😵 X eyes with worry
Success	✨ Sparkling star eyes

Particle Effects

Hearts (♥), Stars (★), Sparkles (✦), Notes (♪), Circles (●), Code symbols, Plus (+)

Inline Commands

/pet-status    # Show detailed pet status
/pet-stats     # Show productivity statistics
/pet-feed      # Feed the pet
/pet-play      # Play with pet
/pet-sleep     # Toggle sleep mode

---

Installation

pip install claude-pet-companion

From Source

git clone https://github.com/anthropics/claude-pet-companion.git
cd claude-pet-companion
pip install -e .

---

Controls

Right-Click Menu

Feed      - Restore hunger (+30)
Play      - Increase happiness (+25)
Interact  - Quick happiness (+10)
──────────────────────────
Sleep/Wake - Toggle sleep mode
Status     - View detailed stats
Theme      - Change colors
──────────────────────────
Exit       - Close pet

Mouse Actions

• Double click - Pet jumps + hearts
• Right click - Open menu
• Drag - Move pet

---

Configuration

Edit ~/.claude-pet-companion/config.json:

{
  "theme": "default",
  "animation_speed": 1.0,
  "pet_name": "Buddy",
  "target_fps": 40
}

---

Requirements

• Python 3.8+
• tkinter (usually included with Python)

---

License

MIT License

---

Credits

Made with ❤️ for the Claude Code community