@pi-extensions/pi-pacman

Pac-Man working indicator for pi: replaces the streaming spinner with pellet runs, ghost chases, and more

Package details

extension

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

$ pi install npm:@pi-extensions/pi-pacman

Pi manifest JSON

{
  "extensions": [
    "./index.ts"
  ],
  "image": "https://raw.githubusercontent.com/smarzban/pi-extensions/main/packages/pi-pacman/pac-man.gif"
}

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

Pac-Man working indicator for pi: replaces the streaming spinner with pellet runs, ghost chases, arcade tunnels, and fruit bonuses.

Part of the pi-extensions monorepo.

Pac-Man working indicator

Drop-in working indicator: uses setWorkingIndicator / setWorkingMessage (normal streaming only)
Five looks: full-width classic & chase, plus fixed-width mini, arcade, fruit (default 10 cells, configurable)
Rotate mode: cycle short looks every agent message (/pacman rotate)
Random working blurbs: arcade + AI/token-flavored lines each run (or lock your own)
Remembers your choice: look, rotate, cells, and custom message in ~/.pi/agent/pacman-thinking.json

pi install npm:@pi-extensions/pi-pacman

Restart pi (or start a new session), send a message, and you should see a yellow ᗧ chomping pellets next to the working line:

ᗧ······  waka waka...

Default look is classic (full-width pellet run). Footer status shows ᗧ classic while the extension is active.

The indicator only appears while the agent is streaming a normal response, not during compaction/retry loaders.

Method	Loads	Command
npm (recommended)	This package only	`pi install npm:@pi-extensions/pi-pacman`
local path	This package only	`pi install /absolute/path/to/pi-extensions/packages/pi-pacman`
git (whole monorepo)	All packages in the repo	`pi install git:github.com/smarzban/pi-extensions`

More detail: docs/install (one package vs whole monorepo).

/pacman list
/pacman chase
/pacman rotate
/pacman cells 12
/pacman message chomping tokens...
/pacman off

Command	Result
`/pacman`	Current look, rotate, cells, message, strip width
`/pacman list`	Catalog under the editor
`/pacman <look>`	Lock a look (stops rotate)
`/pacman rotate`	Cycle short looks every message
`/pacman cells [n]`	Fixed-look width (default 10, range 4–40)
`/pacman message …`	Lock custom working text (empty = auto-random)
`/pacman off`	Hide indicator

Look	Notes
`classic`	Full-width pellet run (default)
`chase`	Full-width Blinky hunt → power pellet → revenge
`mini` / `arcade` / `fruit`	Fixed-width animations (in rotate); width via `cells` config