Pi packages monorepo: installable pi coding-agent extensions, published under the npm org @pi-extensions.
Each package under packages/ is independent: its own package.json, entrypoint, README, and version. Users usually install one package via npm. Git monorepo install loads every package; local path installs a single package directory.
- One extension per package: no cross-package dependencies
- TypeScript, no build step: pi loads sources via jiti
- npm org
@pi-extensions: scoped, public packages withpi-packagekeywords for gallery discoverability - Tag-driven releases: per-package
pi-<name>-vX.Y.Z→ GitHub Actions OIDC → npm
| Package | npm | Description |
|---|---|---|
| pi-pacman | @pi-extensions/pi-pacman |
Pac-Man working / thinking indicator |
| pi-statusline | @pi-extensions/pi-statusline |
Rounded editor box with bottom-right session name; model/effort, context, usage, git/PR footer |
Package docs, install, and commands live in each package’s README (e.g. packages/pi-pacman/README.md).
Install a package into pi (example: pi-pacman):
pi install npm:@pi-extensions/pi-pacmanRestart pi (or start a new session) so the extension loads. See the package README for what to expect and how to configure it.
Other install methods:
| Method | Loads | Command |
|---|---|---|
| npm (recommended) | One package | pi install npm:@pi-extensions/<name> |
| local path | One package | pi install /absolute/path/to/pi-extensions/packages/pi-<name> |
| git (whole monorepo) | All packages | pi install git:github.com/smarzban/pi-extensions |
Details: docs/install/.
| Audience | Start here |
|---|---|
| Users (per package) | packages/pi-pacman/README.md · docs/usage/ |
| Install / release | docs/install/ · docs/releases.md |
| Contributors | docs/development.md · CONTRIBUTING.md |
| Overview | docs/architecture.md · docs/README.md |
pi-extensions/
├── packages/
│ └── pi-<name>/ # one installable pi package each
│ ├── index.ts
│ ├── package.json # "pi": { "extensions": [...] }
│ └── README.md
├── docs/
└── .github/workflows/ # CI + OIDC npm release on v* tags
Modeled after ogulcancelik/pi-extensions.
See CONTRIBUTING.md. Releases are tag-driven (per-package pi-<name>-v*) via GitHub Actions OIDC. See docs/releases.md.
MIT © Saeed Marzban