简体中文 / 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.
🐾 Virtual Pet System
🎭 Animated Expressions based on energy levels
(^_^) (^o^) (^_^) (^v^) - Your pet is thriving!(o_o) (O_O) (o_o) (-_-) - Needs some attention(u_u) (T_T) (u_u) (>_<) - Time to feed your pet(x_x) (X_X) (x_x) (+_+) - Your pet needs urgent care!📊 Rich Status Display
⚙️ Configurable & Persistent
To use ccpet as your Claude Code status line, add this to your ~/.claude/settings.json:
{
"statusLine": {
"type": "command",
"command": "npx ccpet@latest",
"padding": 0
}
}
For better performance, you can install globally:
npm install -g ccpet
Then update your settings to use the global path.
ccpet # Show status line (for Claude Code)
ccpet --help # Show help information
ccpet --version # Show version number
ccpet check # Manually check pet status (no token cost)
ccpet check --watch # Continuous monitoring mode (60s interval)
ccpet check -w --interval 30 # Watch mode with 30s interval
ccpet check --help # Show check command help
Use ccpet check to:
ccpet config list # Show current configuration
ccpet config set <key> <value> # Set configuration value
ccpet config reset # Reset to default configuration
ccpet config path # Show configuration file location
ccpet reset # Trigger pet death and graveyard preservation
ccpet reset --help # Show reset command help
Use ccpet reset to:
~/.claude-pet/graveyard/ccpet sync # Sync pet and token usage data to Supabase
ccpet sync --dry-run # Preview sync without making changes
ccpet sync --verbose # Show detailed sync progress
ccpet sync --start-date 2024-01-01 # Sync from specific date
ccpet sync --end-date 2024-12-31 # Sync until specific date
ccpet sync --help # Show sync command help
Use ccpet sync to:
Setup: ccpet comes with Supabase pre-configured for instant sync - just install and start using!
Web Leaderboard: View the global pet leaderboard online at https://ccpet.surge.sh/ - see how your pet ranks against others worldwide!
ccpet leaderboard # Show today's token leaderboard
ccpet leaderboard --period 7d # Show 7-day leaderboard
ccpet leaderboard --period 30d # Show 30-day leaderboard
ccpet leaderboard --period all # Show all-time leaderboard
ccpet leaderboard --sort cost # Sort by cost instead of tokens
ccpet leaderboard --sort survival # Sort by survival time
ccpet leaderboard --limit 20 # Show top 20 entries
ccpet leaderboard --verbose # Show detailed query info
ccpet leaderboard --help # Show leaderboard command help
Use ccpet leaderboard to:
Leaderboard Features:
today, 7d (7 days), 30d (30 days), all (all-time)tokens (default), cost, survivalConfiguration Options:
# Colors (format: #RRGGBB or #RRGGBB:bright or #RRGGBB:bright:bold)
ccpet config set colors.petExpression "#FF0000:bright:bold"
ccpet config set colors.petName "#FF69B4:bright"
ccpet config set colors.energyBar "#00FF00"
ccpet config set colors.energyValue "#00FFFF"
ccpet config set colors.lifetimeTokens "#FF00FF"
# Pet behavior
ccpet config set pet.animationEnabled true
ccpet config set pet.decayRate 0.0231
# Multi-line display (NEW!)
ccpet config set display.maxLines 3 # Show up to 3 lines (1-3)
ccpet config set display.line1.enabled true # Enable/disable custom line 1
ccpet config set display.line1.items "expression,energy-bar,energy-value" # What to show on line 1
ccpet config set display.line2.enabled true # Enable/disable line 2
ccpet config set display.line2.items "input,output" # What to show on line 2
ccpet config set display.line3.enabled true # Enable/disable line 3
ccpet config set display.line3.items "total" # What to show on line 3
Available Display Items:
expression, energy-bar, energy-value, accumulated-tokens, lifetime-tokens, pet-nameinput, output, cached, total, context-length, context-percentage, context-percentage-usable, costNote: Currently, pet-related elements can only be used on Line 1, and session/context elements can only be used on Lines 2-3.
Monitor your pet in real-time with the new watch mode:
# Start continuous monitoring (default 60s interval)
ccpet check --watch
# Custom monitoring interval (10-300 seconds)
ccpet check --watch --interval 30
# Short form
ccpet check -w --interval 45
Features:
Example Output:
Fluffy 🐶(^_^) ●●●●●●●●●● 100.00 (838.9K) 💖25.84M
⏰ 距离上次喂食: 0分钟前
⏳ 下次更新: 10秒
Note: The display updates in-place every interval, replacing the previous content for a clean monitoring experience.
Luna 🐶(^o^) ●●●●●●●●●● 98.52 (45.2K) 💖5.2M
Input: 2847 Output: 1256 Cached: 512 Total: 4615
Ctx: 2.4K Ctx: 12.0% Ctx(u): 88.5% Cost: $0.15
Note: Pet names are controlled by including pet-name in the display.line1.items configuration. Position the pet-name element wherever you want it to appear on the first line. Context metrics (Ctx(u)) display in light green. Cost metrics show the total USD cost of your current session.
Configure with: ccpet config set display.maxLines 1
Luna 🐶(^o^) ●●●●●●●●●● 98.52 (45.2K) 💖5.2M
Configure with: ccpet config set display.maxLines 2
Luna 🐶(^o^) ●●●●●●●●●● 98.52 (45.2K) 💖5.2M
Input: 2847 Output: 1256 Cached: 512 Total: 4615
ccpet config set display.line1.items "expression,energy-bar,energy-value,accumulated-tokens,lifetime-tokens"
🐶(^o^) ●●●●●●●●●● 98.52 (45.2K) 💖5.2M
Input: 2847 Output: 1256 Cached: 512 Total: 4615
ccpet config set display.line1.items "expression,pet-name,energy-bar,energy-value,accumulated-tokens,lifetime-tokens"
🐶(^o^) Luna ●●●●●●●●●● 98.52 (45.2K) 💖5.2M
ccpet config set display.line1.items "pet-name,expression,energy-value"
ccpet config set display.line2.items "input,output"
ccpet config set display.line3.items "total,context-percentage-usable"
Luna 🐶(^o^) 98.52
Input: 2847 Output: 1256
Total: 4615 Ctx(u): 88.5%
Display Format:
expression, energy-bar, energy-value, accumulated-tokens, lifetime-tokens, pet-nameinput, output, cached, total, context-length, context-percentage, context-percentage-usable, costPet Name Display:
pet-name in display.line1.itemspet-name appears in the items list"pet-name,expression,energy-bar" (name first), "expression,pet-name,energy-bar" (name after expression)If your pet's energy reaches 0:
~/.claude-pet/graveyard/ccpet automatically preserves your pet's legacy when they pass away:
Automatic History Saving:
~/.claude-pet/graveyard/{petName}/Fluffy-2/, Fluffy-3/)Graveyard Structure:
~/.claude-pet/
├── pet-state.json # Current pet
└── graveyard/
├── Fluffy/
│ └── pet-state.json # Complete final state
├── Shadow/
│ └── pet-state.json # Complete final state
├── Luna-2/ # Same-name handling
│ └── pet-state.json
└── ...
What's Preserved:
Atomic Operations:
The status line only updates when you use Claude Code. Use ccpet check for manual updates.
cat ~/.claude/settings.jsonccpet --versionccpet checkPet state is stored in ~/.claude-pet/pet-state.json with the following structure:
energy: Current energy level (0-100)expression: Current facial expressionanimalType: Pet species (cat, dog, rabbit, panda, fox)petName: Unique name for each pet (auto-generated)birthTime: When the pet was born/reborn (ISO timestamp)lastFeedTime: Last feeding timestamptotalTokensConsumed: Total tokens consumed this lifecycletotalLifetimeTokens: Lifetime token consumptionaccumulatedTokens: Tokens waiting to convert to energylastDecayTime: Last energy decay calculation timestampsessionTotalInputTokens, sessionTotalOutputTokens, etc.Graveyard Storage:
~/.claude-pet/graveyard/{petName}/pet-state.jsonThe system automatically adds missing fields (like birthTime and petName) for backward compatibility.
ccpet features a smart pet naming system with cultural diversity:
Sample Names:
npm test # Run all tests
npm run test:coverage # Run tests with coverage report
npm run build # Build distribution files
npm run watch # Build and watch for changes
MIT License
Enjoy your virtual coding companion! 🐾
Remember: A well-fed pet is a happy pet. Keep coding to keep your pet healthy!
FAQs
A Claude Code status line script that displays a virtual pet
The npm package ccpet receives a total of 16 weekly downloads. As such, ccpet popularity was classified as not popular.
We found that ccpet demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Research
/Security News
The North Korean malware loader hides in a Packagist-listed package and its GitHub branch to fetch and execute remote code in a likely Contagious Interview-style lure.
Security News
The Rust project is moving toward formal rules on LLM use in contributions after months of internal debate over maintainer burden, code quality, and contributor experience.
Research
/Security News
A malicious NuGet package impersonating Sicoob exfiltrated client IDs, PFX passwords, and banking certificates through Sentry telemetry.