🐾 pi-pet

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

Features

• 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

Install

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

Commands

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

How It Works

Feeding

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!

Leveling

• Every 50,000 tokens consumed earns your pet one level
• Level milestones are announced every 5 levels

Life Stages

| Stage | Level Required | |-------|---------------| | 🐣 Baby | 0 | | 🧒 Child | 5 | | 🧑 Teen | 15 | | 🧑‍🦱 Adult | 30 | | 👴 Elder | 60 | | ✨ Legendary | 100 |

Hunger & Mood

• 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 Data

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

ASCII Art

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 ✦

License

MIT