claude-pet-companion 2.4.0

A virtual pet for Claude Code with daemon mode, IPC, and conversation history

Claude Pet Companion

A virtual pet for Claude Code with evolution system, memory tracking, conversation history, and productivity features.

---

Quick Start

pip install claude-pet-companion

Desktop Pet

claude-pet

Claude Code Plugin

claude-pet install

---

What's New in v2.3.1

• Fixed Installation Bugs - Fixed check_installed() and data_dir issues
• Error Handling System - Centralized logging and error management
• Cross-Platform Audio - Sound effects system (Windows/macOS/Linux)
• Extended Achievements - 30+ achievements with rarity levels
• Customization System - Accessories, colors, and appearance options
• Animation Library - Keyframe animations with easing functions
• Minigames - Catch and Memory games with rewards
• Unit Tests - 36 tests with 100% pass rate

v2.3 Features

• Daemon Mode - Single-instance background process
• IPC Communication - Real-time pet state queries
• Conversation History - Save and restore chat contexts
• /pet:restore - Continue previous conversations
• /pet:continue - Seamless conversation continuation

---

Usage Guide

Desktop Pet

# Launch pet
claude-pet

# Daemon commands
claude-pet daemon start    # Start background daemon
claude-pet daemon status   # Check status
claude-pet daemon stop     # Stop daemon

Claude Code Commands

Command	Description
/pet:status	View pet stats, level, mood
/pet:feed	Feed pet (+30 hunger)
/pet:play	Play with pet (+25 happiness)
/pet:sleep	Toggle sleep mode
/pet:restore	List & restore conversations
/pet:continue [id]	Continue a conversation

Conversation History

# List recent conversations
/pet:restore

# Restore specific conversation
/pet:restore abc123

# Continue conversation
/pet:continue abc123

---

Evolution System

10 Stages

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

5 Paths

Path	Style
Coder	Blue/Green tech theme
Warrior	Orange/Red battle theme
Social	Pink/Heart cute theme
Night Owl	Purple/Yellow mystery
Balanced	Green/Teal harmony

---

Features

• 3D Pseudo-Rendering - Multi-layer depth with dynamic lighting
• Memory System - Remembers your coding activities
• Productivity Tracking - Score, focus, combos, flow state
• 5 Themes - Blue, Pink, Green, Dark, Purple
• Mouse Tracking - Eyes follow cursor
• Dynamic Expressions - Happy, thinking, working, error, success

---

Configuration

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

{
  "theme": "default",
  "pet_name": "Claude",
  "animation_speed": 1.0,
  "daemon_enabled": true,
  "ipc_port": 15340
}

---

Requirements

• Python 3.8+
• tkinter (included with Python)

---

License

MIT License