Skip to content

gotgenes/pi-packages

Repository files navigation

pi-packages

A monorepo of Pi extension packages, published to npm under @gotgenes/. Some packages (like pi-permission-system) are designed for broad use; others scratch a personal itch and are shared in case they help others.

Packages

Package Description
@gotgenes/pi-autoformat Prompt-end auto-formatting (Biome, Prettier, etc.)
@gotgenes/pi-github-tools Deterministic GitHub CI, release, and issue tools
@gotgenes/pi-permission-system Permission enforcement for the Pi coding agent
@gotgenes/pi-subagents Claude Code-style autonomous sub-agents for Pi

Each package has its own README with setup instructions, usage, and configuration details.

Install

Install every package in this repo at once:

pi install git:github.com/gotgenes/pi-packages

Or install a single package via npm:

pi install npm:@gotgenes/<package-name>

Uninstall

If installed via git:

pi remove git:github.com/gotgenes/pi-packages

If installed individually via npm:

pi remove npm:@gotgenes/<package-name>

Development

Prerequisites

  • Node.js ≥ 20
  • pnpm 11

Setup

pnpm install

Commands

pnpm run check    # typecheck all packages
pnpm run test     # test all packages
pnpm run lint     # biome + rumdl
pnpm run lint:fix # auto-fix lint issues

Agentic development workflow

Always start Pi from the repo root:

pi

This gives the agent access to:

  • .pi/settings.json — loads all packages from local source (with npm versions disabled)
  • .pi/prompts/ — slash commands (/plan-issue, /tdd-plan, /ship-issue, etc.)
  • Root AGENTS.md — monorepo-wide conventions

Package-specific context (architecture, priorities, testing strategy) lives in skills. Load the relevant skill before working on a package:

  • package-pi-autoformat — for packages/pi-autoformat/
  • package-pi-github-tools — for packages/pi-github-tools/
  • package-pi-permission-system — for packages/pi-permission-system/
  • package-pi-subagents — for packages/pi-subagents/

The one exception is pi-autoformat: because it hooks into file mutations made by the agent, you typically test it by installing it into a separate target project rather than running it against itself.

License

MIT

About

Monorepo for @gotgenes pi packages

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors