claude-pet-companion 2.0.1

A pixel-art virtual pet plugin for Claude Code

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.

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:

   # Double-click
   启动Claude宠物HD.vbs
   
   # Or from command line
   python claude_pet_companion/claude_pet_hd.py
   

From Source

# 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