@smarzban/pi-pacman

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.

Highlights

• 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

Quickstart

pi install npm:@smarzban/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.

Install

| Method | Loads | Command | |--------|-------|---------| | npm (recommended) | This package only | pi install npm:@smarzban/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).

Usage

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

Full reference: docs/usage/commands.md.

Looks

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

Details: docs/usage/looks.md. Persistence: docs/usage/persistence.md.

Documentation

| Doc | What | |-----|------| | Quickstart | Fastest path to first chomp | | Commands | Every /pacman subcommand | | Looks | Frame / width notes | | Persistence | State file fields | | Architecture | How the extension hooks pi | | Releases | Maintainer publish flow |

License

MIT