Claude Code Tamagotchi

Claude Code Tamagotchi 🐾
*Real-time behavioral enforcement for Claude Code, disguised as a virtual pet*

🚨 EXPERIMENTAL FEATURE: BEHAVIORAL ENFORCEMENT SYSTEM 🚨

This pet now includes an experimental behavioral enforcement system that monitors Claude's actions in real-time and can block operations that violate your instructions. Think of it as a safety net that ensures Claude stays on track with what you actually asked for. This feature is in active development and may occasionally flag legitimate operations - we're tuning it based on real-world usage.

📢 Help Us Make This Amazing: If you encounter false positives (legitimate actions blocked), please open an issue! Your feedback is crucial for refining this feature. Include:
- What Claude was trying to do
- What you actually asked for
- The violation message

Every report helps us make the violation detection smarter and more accurate

Table of Contents

- What's This All About?
- Quick Start
- Installation Options
- AI-Powered Behavioral Monitoring
- Commands & Interaction
- Understanding Your Pet
- The Thought System
- Configuration
- FAQ
- Troubleshooting
- Contributing

What's This All About? 🎮

Hey! Welcome to Claude Code Tamagotchi - a digital friend that lives in your Claude Code statusline and keeps you company while you build cool stuff. It's literally a Tamagotchi for developers, but instead of a keychain, it lives where you work.

But here's the twist: this isn't just a virtual pet. It's a real-time behavioral enforcement system that monitors Claude Code's actions, detects when it's going off-track, and can actually interrupt operations that violate your instructions. The pet is the friendly face of a sophisticated AI accountability system.

Your pet lives right in your statusline, breathing, thinking,…