Pi Userland

Monorepo of independently publishable Pi packages.

Small, focused packages to augment your Pi environment without adding unnecessary overhead.

Packages

Package	Description
pi-merge-ready	PR merge-readiness for Pi: status bar and slash-command status, exact PR URL targeting, blocker context, and agent repair loops.
pi-openrouter	OpenRouter usage/account overlays, model sync, api key management, and session tagging for Pi.
pi-session-deck	Pi runtime presence foundation: heartbeat-backed presence records with live/stale views, optional --all diagnostics, and --reap cleanup.
pi-session-hygiene	Status bar indicator for session cost, context, and cache rate to track session health
pi-spinner-verbs	Customizes thinking text with themed verbs (e.g., "Paying the iron price...", "With fire and blood...") for sessions with more personality.
pi-structured-return	Save money by turning noisy CLI output into compact structured results (fewer tokens), full logs preserved.
pi-yolo-seatbelt	Configurable guardrails for destructive commands. Keep the YOLO workflow but avoid bash catastrophe.

Install

An individual package

pi install npm:@robhowley/[name-of-package]

The full bundle

pi install git:github.com/robhowley/pi-userland

Development

Setup

pnpm install

Checks

pnpm lint
pnpm typecheck
pnpm format:check

Add a package

packages/<name>/

Requirements:

• independently publishable
• narrow scope
• minimal cross-package dependencies

Releasing

Packages are versioned and released independently using conventional commits.

License

MIT