@studiosunnyfield/pimagotchi
Pimagotchi — tamagotchi virtual pet for pi coding agent. 18 animated species, behavior-based evolution, rarity system, and more.
Package details
Install @studiosunnyfield/pimagotchi from npm and Pi will load the resources declared by the package manifest.
$ pi install npm:@studiosunnyfield/pimagotchi- Package
@studiosunnyfield/pimagotchi- Version
1.1.3- Published
- Apr 4, 2026
- Downloads
- 84/mo · 13/wk
- Author
- lenhsherr
- License
- MIT
- Types
- extension
- Size
- 91.7 KB
- Dependencies
- 0 dependencies · 2 peers
Pi manifest JSON
{
"extensions": [
"./extensions"
]
}Security note
Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.
README
🐾 Pimagotchi
Pimagotchi (π + たまごっち) — a tamagotchi virtual pet for pi coding agent. Your pet evolves based on how you code.
Install
pi install npm:@studiosunnyfield/pimagotchi
Features
- 18 animated species — duck, cat, dragon, ghost, axolotl, capybara, and more (3 animation frames each)
- Behavior-based evolution — egg hatches at Lv.3 into a species based on your tool usage: bash warriors get dragons, careful readers get owls, 3am coders get ghosts
- Rarity system — common → legendary, more coding = better odds
- Cosmetics — 6 eye styles, 8 hats (unlocked by rarity), 1% shiny chance ✧
- Animated widget — idle fidgets, blinks, excited during streaming, hearts when petted
- Persistent — your pet follows you across sessions
Usage
| Action | How |
|---|---|
| Action menu | Ctrl+; — overlay with arrow navigation |
| Toggle widget | /pet |
| Rename | /pet <name> |
| Feed | /pet feed |
| Pet | /pet pet |
| Stats | /pet stats |
| Manual hatch | /pet hatch (if Lv.3+) |
Evolution
Your egg hatches into a species based on your coding patterns:
| Pattern | Species Pool |
|---|---|
| Bash-heavy | 🐉 dragon, 🤖 robot, 🪿 goose |
| Edit/write-heavy | 🐱 cat, 🐰 rabbit, 🌵 cactus |
| Read-heavy | 🦉 owl, 🍄 mushroom, 🐢 turtle |
| Night coding | 👻 ghost, 🦎 axolotl |
| High tool count | 🐙 octopus, 🐌 snail |
| Balanced | 🫧 blob, 🦫 capybara, 🐤 duck, 🐧 penguin, 😺 chonk |
Rarity
| Rarity | Base Odds | Hats Available |
|---|---|---|
| ★ Common | 60% | none, beanie |
| ★★ Uncommon | 25% | + propeller |
| ★★★ Rare | 10% | + tophat, wizard |
| ★★★★ Epic | 4% | + crown, halo |
| ★★★★★ Legendary | 1% | + tinyduck |
More tool calls at hatch time = better rarity odds.
Credits
Sprite art adapted from Claude Code's buddy system. Evolution and progression system original.