Metadata-Version: 2.4
Name: claude-pet-companion
Version: 2.2.2
Summary: A 3D virtual pet plugin for Claude Code with 10 evolution stages and 5 paths
Home-page: https://github.com/anthropics/claude-pet-companion
Author: Claude Code Community
Author-email: noreply@example.com
License: MIT
Project-URL: Homepage, https://github.com/anthropics/claude-pet-companion
Project-URL: Documentation, https://github.com/anthropics/claude-pet-companion/blob/main/README.md
Project-URL: Repository, https://github.com/anthropics/claude-pet-companion
Project-URL: Issues, https://github.com/anthropics/claude-pet-companion/issues
Keywords: claude-code,plugin,pet,companion,pixel-art,gamification
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: author-email
Dynamic: home-page
Dynamic: license-file
Dynamic: requires-python

# Claude Pet Companion

![Version](https://img.shields.io/badge/version-2.2.0-blue)
![Python](https://img.shields.io/badge/python-3.8+-green)
![License](https://img.shields.io/badge/license-MIT-green)

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

```bash
pip install claude-pet-companion
```

### From Source

```bash
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`:

```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
