Pi Rig

A suite of extensions for the Pi coding agent.

Pi Rig handles the execution, messaging, routing, and workflow state layers that matter most during long agent runs: queued work, remote updates, scheduled delivery, and consistent runtime context.

Pi Rig is built on pi-mono, the open-source Pi coding agent by Mario Zechner, and targets the Pi extension ecosystem around @mariozechner/pi-agent-core.

Quick demos

Pi Dispatch

Queue-aware profile runs, background jobs, and the flow deck in one short clip.

Theme Switcher

Live theme preview, set, and cycle flow inside a real Pi session.

Pi Rig installer

The installer path for getting the published extensions onto a fresh Pi setup.

Extensions

Extension	Package	Status	Surfaces	Notes
Pi Dispatch	@codewithkenzo/pi-dispatch	Published	flow_run, flow_batch, /flow	Core execution and queue lane
Theme Switcher	@codewithkenzo/pi-theme-switcher	Published	theme_set, theme_list, theme_preview, /theme	Runtime theming and session restore
Pi Blitz	@codewithkenzo/pi-blitz	Published	pi_blitz_* tools	AST-aware symbol edits through the blitz CLI
Gateway Messaging	@codewithkenzo/pi-gateway-messaging	Source preview	gateway_turn_preview, /gateway	Remote turn updates + action routing
Notify Cron	@codewithkenzo/pi-notify-cron	Source preview	notify_cron_*, /notify-cron	Scheduled delivery and lease-aware ticks

Planned roadmap

Planned plugin map

Plugin	Status	Primary goal	Notes
fs-sandbox	Planned	Execution isolation + policy boundaries	sandbox adapter target for Pi Dispatch
pi-memory	Planned	Short/long/last-active memory lanes	selective injection, markdown-first storage
pi-board	Planned	Mission/task coordination surface	planned to absorb interactive plan-mode workflow
pi-voice	Planned	Voice ingress + transcript workflows	pairs with gateway/remote flows
pi-rollback	Deferred	See pi-rewind ecosystem plugin + Pi core rollback	revisit only if fastedit-undo integration needs its own plugin

Phase map

Phase	Scope	What ships
Phase 1 (now)	Public release baseline	Dispatch + Theme Switcher + installer path
Phase 2 (next)	Source preview hardening	Gateway Messaging + Notify Cron packaging hardening
Phase 3 (after)	New extension wave	board/memory/sandbox/diff/voice/rollback lanes

Pi Dispatch direction

• interactive plan mode (/plan, gated execute flow) as the bridge into board workflows
• deeper VFS/preload ergonomics and token-safe context injection
• sandbox adapter integration for safer execution boundaries

Install

Requires Pi coding agent on your PATH.

Pick one extension

pi install npm:@codewithkenzo/pi-dispatch

pi install npm:@codewithkenzo/pi-theme-switcher

pi install npm:@codewithkenzo/pi-blitz

Install everything

With Bun:

bunx @codewithkenzo/pi-rig@latest

With npm:

npx @codewithkenzo/pi-rig@latest

From source

git clone https://github.com/codewithkenzo/pi-rig.git
cd pi-rig
bun run setup

Source-only extensions

pi install ./extensions/gateway-messaging
pi install ./extensions/notify-cron
pi install ./extensions/pi-blitz

Published pi-blitz pulls the native @codewithkenzo/blitz CLI automatically. Source installs can still override the binary with ~/.pi/pi-blitz.json when needed.

Verify

Open a fresh Pi session and run:

/flow profiles
/theme list
/help

You should see pi_blitz_* tools if Pi Blitz is installed.

Agent prompt (copy/paste)

Install Pi Rig extensions.

Run:

```bash
pi install npm:@codewithkenzo/pi-dispatch
pi install npm:@codewithkenzo/pi-theme-switcher
pi install npm:@codewithkenzo/pi-blitz
```

Then restart/open Pi if needed.

Verify:

- `/flow profiles`
- `/theme list`
- `/help` includes `pi_blitz_*` tools
- run `pi_blitz_doctor` if available

Report what installed and any errors.

Development

bun run typecheck     # typecheck all packages
bun run test          # run all tests
bun run build         # build all packages

Each extension is a self-contained Bun workspace package under extensions/.

Documentation

• Install guide
• Usage guide
• Telegram pairing guide
• Documentation index
• Preview asset guide
• Public go-live checklist

Contributing

Good contributions are concrete and scoped:

• reproducible bugs with a minimal reproduction case
• contract and schema fixes
• transport reliability improvements
• packaging and install improvements
• focused behavior changes with clear acceptance criteria
• tests that cover failure-prone paths