Code Pet - 3D Codebase Desktop Widget

A cute 3D animated robot (RobotExpressive) that floats on your desktop and reacts to the health of your codebase. Built with Electron + Three.js.

Features

• 3D Animated Robot with skeletal animations (Idle, Dance, Wave, Jump, ThumbsUp, etc.)
• Codebase Monitoring - analyzes syntax errors, complexity, commit history
• Mood System - Happy, Sad, Sick, Sleeping, Idle states based on code health
• Interactive - click to pet, hover for stats, action buttons for animations
• Floating Ethereum Crystal accessory
• Cursor Tracking - robot follows your mouse

Quick Start

npm install
npm start

How it works

The .agents/hooks.json hook triggers .agents/update_pet.bat on agent Stop events, which runs scripts/update_pet.py to scan the workspace and update src/pet_status.json. The Electron widget reads this file every 3 seconds and adjusts the robot's mood/animations accordingly.