Ccpet

ccpet

简体中文 / Chinese | 🏆 Web Leaderboard

A virtual pet for your Claude Code status line. The pet's energy decays over time, increases when you consume tokens, and persists across sessions.

Features

- 🐾 Virtual Pet System
  - Energy-based pet that responds to your Claude Code usage
  - Time-based decay (~0.0231 per minute, ~3 days from 100 → 0)
  - Feeding via token usage (1,000,000 tokens = +1 energy)

- 🎭 Animated Expressions based on energy levels
  - HAPPY (≥80): (^_^) (^o^) (^_^) (^v^) - Your pet is thriving!
  - HUNGRY (≥40): (o_o) (O_O) (o_o) (-_-) - Needs some attention
  - SICK (≥10): (u_u) (T_T) (u_u) (>_<) - Time to feed your pet
  - DEAD (<10): (x_x) (X_X) (x_x) (+_+) - Your pet needs urgent care!

- 📊 Rich Status Display
  - Colorful energy bar with precise energy values
  - Accumulated tokens and lifetime statistics
  - Real-time session metrics (input/output/cached/total)
  - Pet birth time tracking for lifecycle management

- ⚙️ Configurable & Persistent
  - Customizable colors and decay rates
  - State persists across Claude Code sessions

Installation & Setup

Quick Start
To use ccpet as your Claude Code status line, add this to your ~/.claude/settings.json:

Alternative: Global Installation
For better performance, you can install globally:

Then update your settings to use the global path.

CLI Commands

Basic Usage

Pet Management Commands

Check Command

Use ccpet check to:
- ✅ Check pet status without consuming tokens
- ✅ See time since last feeding
- ✅ Monitor energy levels between sessions
- ✅ NEW: Continuous monitoring with real-time updates
- ✅ NEW: Clean countdown display
- ✅ NEW: Customizable refresh intervals (10-300 seconds)

Configuration Command

Reset Command

Use ccpet reset to:
- ✅ Manually trigger the pet death and…