Skip to content

Repository files navigation

Pi Userland

CI license site npm packages

Monorepo of independently publishable Pi packages.

Small, focused packages to augment your Pi environment without adding unnecessary overhead. Private apps and release builders live under apps/ so packages/* remains independently installable.

Packages

Package Description
pi-session-deck The full Pi session lifecycle in one place: create and organize sessions across repos and worktrees, see what each agent is doing or waiting on, and reopen or end them from a TUI or iTerm2 Toolbelt.
pi-merge-ready Pull requests that explain and repair their own blockers. Give your agents the context they need to take your PR all the way to green.
pi-openrouter OpenRouter usage/account overlays, model sync, api key management, and session tagging for Pi.
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

Add a private app or release builder

apps/<name>/

Private apps can be pnpm workspaces for CI/build coverage, but they are not added to release-please manifests or published to npm.

Releasing

Packages are versioned and released independently using conventional commits.

License

MIT

About

Pi packages for a smarter, streamlined, and more whimsical workflow

Topics

Resources

Contributing

Stars

5 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages