pi-pac-man

Play a terminal-native Pac-Man game inside Pi.

pi-pac-man adds a persistent TUI overlay opened with /pac-man. You move Pac-Man through multi-level ASCII mazes while four local ghosts chase, scatter, and flee deterministically.

Features

• Centered terminal overlay, built with Pi TUI
• Three larger levels
• Four named ghosts: Blinky, Pinky, Inky, and Clyde
• Pellets, power pellets, frightened ghosts, lives, scoring, and level clears
• Arrow-key and WASD input
• Session persistence across Pi reloads/resumes
• Validated saved state, wall collision checks, and deterministic rules
• TypeScript source, no build step required
• Manual npm publish workflow included

Install

pi install npm:pi-pac-man

Or add it to ~/.pi/agent/settings.json:

{
  "packages": ["npm:pi-pac-man"]
}

Usage

Start or resume a game:

/pac-man

Start a fresh game:

/pac-man new

Controls

Key	Action
Arrow keys	Move Pac-Man
W A S D	Move Pac-Man
n	New game
q	Close overlay

The overlay is TUI-only. It will not open in Pi print, JSON, or RPC modes.

Symbols

Symbol	Meaning
Green P	Pac-Man
Red B K I C	Dangerous ghosts
Blue g	Frightened ghost
.	Pellet
o	Power pellet
#	Wall

Development

npm install
npm test
npm run check

Try the extension locally:

pi -e ./extensions/index.ts

Then run:

/pac-man

Package Notes

Pi loads TypeScript extensions directly, so this package publishes the source .ts files. Pi core packages are declared as peer dependencies to avoid bundling duplicate Pi runtime packages.

License

MIT