@vedssharma/pi-pet

A virtual pet for your pi terminal sessions. Pick a pet, feed it tokens, and watch it grow!

Package details

extension

Install @vedssharma/pi-pet from npm and Pi will load the resources declared by the package manifest.

$ pi install npm:@vedssharma/pi-pet

Pi manifest JSON

{
  "extensions": [
    "./extensions"
  ]
}

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

A virtual pet that lives in your pi terminal! Pick a pet, feed it tokens, and watch it grow over sessions.

6 pet species — Cat 🐱, Dog 🐶, Dragon 🐉, Bunny 🐰, Penguin 🐧, Fox 🦊
6 life stages — Baby → Child → Teen → Adult → Elder → Legendary
Token-fed growth — Your pet feeds on tokens consumed during LLM conversations
Persistent across sessions — Your pet lives on between pi sessions
Terminal widget — See your pet and its mood above the editor
Status bar — Quick pet status in the footer

pi install /path/to/pi-pet
# or for a quick test:
pi -e /path/to/pi-pet/extensions/pi-pet.ts

Command	Description
`/pet`	Adopt a new pet (first time) or view stats
`/pet feed`	Give your pet 5K bonus tokens as a treat
`/pet stats`	View detailed pet statistics
`/pet rename <name>`	Rename your pet

Your pet automatically eats tokens from every LLM response. Both input and output tokens count. The more you use pi, the more your pet grows!

Pet hunger increases over time since last feeding
Full (< 1 hour) → Content (< 4 hours) → Hungry (< 12 hours) → Starving!
Happiness decays when your pet goes hungry
Each species has unique mood messages

Pet state is saved to ~/.pi/pi-pet/pet.json and persists across all sessions.

Each pet has unique ASCII art that evolves through all 6 life stages — from tiny babies to legendary creatures adorned with stars and sparkles ✨

  /\_/\       →      ★ /\_____/\ ★
 ( o.o )     →     ✦/  ◆   ◆  \✦
  > ^ <      →    ✧( ==  ▼  == )✧
                   ✦ LEGENDARY CAT ✦

MIT