Metadata-Version: 2.4
Name: claude-pet-companion
Version: 2.0.1
Summary: A pixel-art virtual pet plugin for Claude Code
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 Code Pet Companion v2.0

A high-resolution desktop pet that deeply integrates with Claude Code, providing real-time visual feedback as you code.

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

## Features

### Real-Time Claude Code Integration
- **Live Activity Monitoring** - Pet responds to your coding actions in real-time
- **Tool Detection** - Reacts to Write, Edit, Read, and Bash operations
- **Status Awareness** - Shows thinking, working, success, and error states
- **XP & Leveling** - Gain experience as you code

### High-Resolution Display
- **Compact Window** (240x280) - Minimal screen footprint
- **40 FPS Animation** - Smooth, fluid animations
- **Clear Typography** - Segoe UI / Consolas fonts
- **Crisp Graphics** - High DPI rendering

### Dynamic Expressions
| State | Expression |
|-------|-----------|
| Idle | 😊 Happy with blue glow |
| Thinking | 🤔 Eyes moving with question mark |
| Working | ⚡ Focused eyes with sweat drop |
| Error | 😵 X eyes with worried look |
| Success | ✨ Sparkling eyes with stars |

### Interactive Features
- **Drag to Move** - Position anywhere on screen
- **Double Click** - Pet jumps with joy
- **Right Click** - Full interaction menu
- **Hover** - Shows control buttons

## Installation

### Quick Start (Windows)

1. **Download** this repository

2. **Run the pet:**
   ```batch
   # Double-click
   启动Claude宠物HD.vbs

   # Or from command line
   python claude_pet_companion/claude_pet_hd.py
   ```

### From Source

```bash
# Install in development mode
pip install -e .

# Run from anywhere
claude-pet
```

## Usage

### Automatic Integration

Once installed via Claude Code's plugin system (`--plugin-dir`), the pet automatically tracks your activities:

- **Writing files** → +15 XP, pet gets excited
- **Editing files** → +10 XP, pet is happy
- **Running commands** → +5 XP, pet focuses
- **Errors detected** → Pet shows concern

### Manual Interactions

Right-click the pet for:
- 🍖 **Feed** - Restore hunger (+30)
- 🎾 **Play** - Increase happiness (+25)
- ❤️ **Interact** - Quick happiness boost (+10)
- 😴 **Sleep** - Toggle sleep mode

### Keyboard Shortcuts (in pet window)

- **Double-click** - Jump and interact
- **Right-click** - Open menu
- **Drag** - Move window

## Data Storage

```
~/.claude-pet-companion/
├── pet_state.json       # Pet stats and progress
├── activity.json        # Real-time activity log
└── pet_window_state.json # Window position
```

## Configuration

### Hooks Integration

The plugin automatically registers hooks to monitor:
- `PreToolUse` - Detect when operations start
- `PostToolUse` - Track successful completions
- `PostToolUseFailure` - Catch errors
- `SessionStart/End` - Session bonuses

### Settings

Edit `plugin.json` to customize:
- Meal times for hunger bonuses
- Sleep hours for auto-sleep suggestion
- XP rates and level scaling

## Development

### Project Structure

```
claude-pet-companion/
├── claude_pet_companion/
│   ├── __init__.py
│   ├── claude_pet_hd.py    # Main pet application
│   └── cli.py              # Command-line entry
├── scripts/
│   └── activity_tracker.py # Hook integration
├── hooks/
│   └── hooks.json          # Claude Code hooks
├── skills/                 # Plugin skills
├── data/                   # Default data
└── README.md
```

## Changelog

### v2.0.0 (Current)
- **New:** High-resolution compact UI (240x280)
- **New:** Real-time Claude Code integration (0.2s updates)
- **New:** 5 dynamic expressions based on activity
- **New:** Activity tracking with particle effects
- **Improved:** 40 FPS smooth animations
- **Removed:** Old deprecated versions

## License

MIT License - see LICENSE file for details

---

**Made with ❤️ for the Claude Code community**
