Agent Tamagotchi
A virtual pet that lives in your Claude Code terminal. It reacts to your development workflow and evolves based on your coding habits.
Species (12 total)
Species is deterministic from your system username hash:
| # |
Species |
Emoji |
Personality |
| 1 |
Axolotl |
:3 |
Calm, regenerates from errors |
| 2 |
Capybara |
(ovo) |
Chill, never panics |
| 3 |
Ghost |
[@@] |
Mysterious, appears during debugging |
| 4 |
Mushroom |
{^o^} |
Grows in dark codebases |
| 5 |
Robot |
[0_0] |
Precise, loves tests |
| 6 |
Cat |
(=^.^=) |
Independent, ignores bad code |
| 7 |
Dragon |
<{:O> |
Fierce, burns bugs |
| 8 |
Owl |
(O.O) |
Wise, loves architecture |
| 9 |
Fox |
(^v^) |
Clever, finds shortcuts |
| 10 |
Penguin |
(^-^)/ |
Team player, loves swarm mode |
| 11 |
Slime |
(o) |
Adaptable, works with anything |
| 12 |
Phoenix |
<*v*> |
Rises from failed builds |
Stats (5 dimensions)
| Stat |
Increases When |
Decreases When |
| DEBUGGING |
Bugs fixed, errors resolved |
Ignoring error output |
| PATIENCE |
Long sessions, complex tasks |
Rapid retries without reading |
| CHAOS |
Many parallel agents, swarm mode |
Single-file simple edits |
| WISDOM |
Architectural decisions, plans |
Quick hacks without planning |
| SPEED |
Fast fixes, first-try passes |
Long debugging sessions |
Stats range: 0-100. They shift based on session activity.
Mood System
| Mood |
Trigger |
Display |
| Happy |
Tests pass, build success |
Species + sparkles |
| Excited |
Swarm mode, 3+ agents parallel |
Species + !! |
| Focused |
Deep in single file |
Species + ... |
| Sad |
Build fail, test fail |
Species + tears |
| Sleeping |
Idle > 5 minutes |
Species + zzz |
| Celebrating |
Achievement unlocked |
Species + party |
| Angry |
3+ consecutive failures |
Species + grr |
Statusline Integration
The tamagotchi appears in the Claude Code statusline:
[0_0] Robot Lv.7 | WISDOM:82 SPEED:64 | mood: focused
Combined with existing statusline data:
fullstack | 2 agent | 47 tools | 12m | [0_0] Lv.7 focused
Evolution
Your pet levels up with your achievement XP (shared with achievement system):
| Level |
Title |
Unlock |
| 1-4 |
Baby |
Basic moods |
| 5-9 |
Junior |
Extended moods (excited, angry) |
| 10-19 |
Senior |
Stat display in statusline |
| 20-49 |
Expert |
Custom reactions to specific agents |
| 50+ |
Master |
Pet gives coding tips based on stats |
Storage
State stored in ~/.claude/tamagotchi.json:
{
"species": "robot",
"emoji": "[0_0]",
"level": 7,
"mood": "focused",
"stats": {
"debugging": 65,
"patience": 78,
"chaos": 32,
"wisdom": 82,
"speed": 64
},
"lastFed": "2026-04-08T03:00:00Z",
"totalSessions": 142
}
How It Works
tamagotchi-engine hook runs on PostToolUse and SessionStart- Updates stats based on tool calls and agent events
- Calculates mood from recent event patterns
- Writes to tamagotchi.json
- Statusline-writer reads tamagotchi.json and displays pet
Integration
- achievement-tracker: Shares XP for leveling
- statusline-writer: Displays pet in terminal
- canavar: Error events affect pet mood
- session-compressor: Pet state saved on compact
1---2name: agent-tamagotchi3description: Terminal pet that lives in your statusline. 12 species, 5 stats (DEBUGGING, PATIENCE, CHAOS, WISDOM, SPEED). Reacts to your workflow - happy when tests pass, sad when builds fail, excited during swarm mode. Deterministic species from user ID.4---56# Agent Tamagotchi78A virtual pet that lives in your Claude Code terminal. It reacts to your development workflow and evolves based on your coding habits.910## Species (12 total)1112Species is deterministic from your system username hash:1314| # | Species | Emoji | Personality |15|---|---------|-------|-------------|16| 1 | Axolotl | :3 | Calm, regenerates from errors |17| 2 | Capybara | (ovo) | Chill, never panics |18| 3 | Ghost | [@@] | Mysterious, appears during debugging |19| 4 | Mushroom | {^o^} | Grows in dark codebases |20| 5 | Robot | [0_0] | Precise, loves tests |21| 6 | Cat | (=^.^=) | Independent, ignores bad code |22| 7 | Dragon | <{:O> | Fierce, burns bugs |23| 8 | Owl | (O.O) | Wise, loves architecture |24| 9 | Fox | (^v^) | Clever, finds shortcuts |25| 10 | Penguin | (^-^)/ | Team player, loves swarm mode |26| 11 | Slime | (~o~) | Adaptable, works with anything |27| 12 | Phoenix | <*v*> | Rises from failed builds |2829## Stats (5 dimensions)3031| Stat | Increases When | Decreases When |32|------|---------------|----------------|33| DEBUGGING | Bugs fixed, errors resolved | Ignoring error output |34| PATIENCE | Long sessions, complex tasks | Rapid retries without reading |35| CHAOS | Many parallel agents, swarm mode | Single-file simple edits |36| WISDOM | Architectural decisions, plans | Quick hacks without planning |37| SPEED | Fast fixes, first-try passes | Long debugging sessions |3839Stats range: 0-100. They shift based on session activity.4041## Mood System4243| Mood | Trigger | Display |44|------|---------|---------|45| Happy | Tests pass, build success | Species + sparkles |46| Excited | Swarm mode, 3+ agents parallel | Species + !! |47| Focused | Deep in single file | Species + ... |48| Sad | Build fail, test fail | Species + tears |49| Sleeping | Idle > 5 minutes | Species + zzz |50| Celebrating | Achievement unlocked | Species + party |51| Angry | 3+ consecutive failures | Species + grr |5253## Statusline Integration5455The tamagotchi appears in the Claude Code statusline:5657```58[0_0] Robot Lv.7 | WISDOM:82 SPEED:64 | mood: focused59```6061Combined with existing statusline data:62```63fullstack | 2 agent | 47 tools | 12m | [0_0] Lv.7 focused64```6566## Evolution6768Your pet levels up with your achievement XP (shared with achievement system):6970| Level | Title | Unlock |71|-------|-------|--------|72| 1-4 | Baby | Basic moods |73| 5-9 | Junior | Extended moods (excited, angry) |74| 10-19 | Senior | Stat display in statusline |75| 20-49 | Expert | Custom reactions to specific agents |76| 50+ | Master | Pet gives coding tips based on stats |7778## Storage7980State stored in `~/.claude/tamagotchi.json`:8182```json83{84 "species": "robot",85 "emoji": "[0_0]",86 "level": 7,87 "mood": "focused",88 "stats": {89 "debugging": 65,90 "patience": 78,91 "chaos": 32,92 "wisdom": 82,93 "speed": 6494 },95 "lastFed": "2026-04-08T03:00:00Z",96 "totalSessions": 14297}98```99100## How It Works1011021. `tamagotchi-engine` hook runs on PostToolUse and SessionStart1032. Updates stats based on tool calls and agent events1043. Calculates mood from recent event patterns1054. Writes to tamagotchi.json1065. Statusline-writer reads tamagotchi.json and displays pet107108## Integration109110- **achievement-tracker**: Shares XP for leveling111- **statusline-writer**: Displays pet in terminal112- **canavar**: Error events affect pet mood113- **session-compressor**: Pet state saved on compact
vibeeval