agent-tamagotchi

Name: agent-tamagotchi
Author: vibeeval

519stars44forks

How to install agent-tamagotchi?

vibeeval/vibecosystem/agent-tamagotchi

$npx -y skills add vibeeval/vibecosystem --skill agent-tamagotchi

Installs into the current project.

Summary

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.

Files · 1

View on GitHub

SKILL.md

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

People who liked this also viewed

6 picks

Type

agent-tamagotchi

519stars44forks

View on GitHub

How to install agent-tamagotchi?

vibeeval/vibecosystem/agent-tamagotchi

$npx -y skills add vibeeval/vibecosystem --skill agent-tamagotchi

Installs into the current project.

Summary

Files · 1

View on GitHub

SKILL.md

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

People who liked this also viewed

6 picks

Type