# Agent Tamagotchi

Terminal pet that lives in your statusline.

- Repository: https://github.com/vibeeval/vibecosystem (541 stars)
- Category: Testing
- License: MIT
- Last updated: 2026-08-08
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add vibeeval/vibecosystem --skill agent-tamagotchi -g -a claude-code -y`
Codex: `npx skills add vibeeval/vibecosystem --skill agent-tamagotchi -g -a codex -y`
Cursor: `npx skills add vibeeval/vibecosystem --skill agent-tamagotchi -g -a cursor -y`
Gemini CLI: `npx skills add vibeeval/vibecosystem --skill agent-tamagotchi -g -a gemini-cli -y`

## Description

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.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# 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:

The rest: https://github.com/vibeeval/vibecosystem/blob/HEAD/skills/agent-tamagotchi/SKILL.md