@anson-no-bug/pi-pet-plus

A real-time pet companion for pi with progression, localization, and optional news delivery

Packages

Package details

extension

Install @anson-no-bug/pi-pet-plus from npm and Pi will load the resources declared by the package manifest.

npm repohome report
$ pi install npm:@anson-no-bug/pi-pet-plus
Package
@anson-no-bug/pi-pet-plus
Version
0.2.1
Published
Apr 8, 2026
Downloads
37/mo · 3/wk
Author
anson-no-bug
License
MIT
Types
extension
Size
181.8 KB
Dependencies
0 dependencies · 2 peers
Pi manifest JSON
{
  "extensions": [
    "./src/pet-core.ts",
    "./src/pet-news.ts"
  ]
}

Security note

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

README

@anson-no-bug/pi-pet-plus

English | 中文文档

A persistent pet companion for pi with:

  • compact ASCII widget rendering
  • long-term progression
  • zh/en localization
  • optional pet-news headline delivery
  • global persistence across projects and sessions

Install

From npm

pi install npm:@anson-no-bug/pi-pet-plus

Local development

pi -e ./src/index.ts

What you get

Companion modules

  • pet-core
    • pet widget
    • progression
    • speech bubble layer
    • commands and settings
  • pet-news
    • headline fetching
    • feed rotation
    • speech-first delivery
    • optional footer mode

Current roster

  • Cat
  • Dog
  • Cow
  • Horse
  • Spark Mouse
  • Seedling
  • Drakelet

Progression

Visible phases before branching:

  1. Baby
  2. School
  3. High School
  4. University

Career tracks after graduation:

  • Academia: Master's → PhD → Professor → Academician
  • Engineering: Intern → Engineer → Senior Engineer → Domain Expert

Interactive usage

Main pet menu

Open the menu:

/pet

From there you can:

  • view status
  • switch pets
  • create pets
  • delete pets
  • open pet-news
  • choose a branch after graduation
  • open settings
  • show/hide the widget

News menu

Open directly:

/news

Or from the pet menu:

/pet news

In the news overlay, use Open ↗ to open the full article link.

Slash commands

Pet commands

/pet
/pet status
/pet new
/pet rename <name>
/pet switch
/pet switch <name>
/pet delete <name>
/pet news
/pet branch
/pet preview <state>
/pet demo
/pet config
/pet toggle

News commands

/news
/news open
/news toggle
/news on
/news off
/news next
/news prev
/news refresh
/news config
/news add-rss <url> [label]
/news remove <sourceId>
/news status

Settings and defaults

Current defaults:

  • pet animation speed: 0.5 FPS
  • news rotation speed: 100ms
  • locale: zh
  • news presentation: speech

Configure through:

/pet config
/news config

Development / QA commands

Useful when testing visuals locally:

/pet dev xp <totalXp>
/pet dev stage <baby|kindergarten|elementary|middle-school|high-school|university>
/pet dev branch <none|academia|engineering> [rank]
/pet dev reset

Examples:

/pet dev stage baby
/pet dev stage university
/pet dev branch academia 4
/pet dev branch engineering 4

Storage

Global files live in:

  • ~/.pi/agent/pet/config.json
  • ~/.pi/agent/pet/state.json
  • ~/.pi/agent/pet/news-cache.json

Development

npm run typecheck
npm test

Docs

License

MIT