🧩 @arhen Pi Extensions

Minimalist Pi Coding Agent extensions. One package, one problem. No config surfaces, minimal context footprint. Independently installable, published separately under the @arhen npm scope.

This is the single source of truth — all extensions are maintained here in one monorepo. The old standalone repos are archived and point here.

Layout

packages/
├── core/        → essential extensions (installed by the toolset)
│   ├── pi-core-ask/
│   ├── pi-core-skill-tool/
│   ├── pi-core-subagent/
│   ├── pi-core-todo/
│   ├── pi-core-tps-stats/
│   └── pi-core-vision/
├── add/         → optional/extra extensions (opt in)
│   ├── pi-add-9router/
│   ├── pi-add-code-diagnostic/
│   ├── pi-add-commandcode/
│   ├── pi-add-vantis/
│   ├── pi-add-wafer/
│   └── pi-senja/
└── pi-toolset/  → installer: manage the installed set

🚀 Install

The easiest way to get the whole core set at once is the toolset:

npm i -g @arhen/pi-toolset
pi-toolset install          # installs all @arhen/pi-core-* packages

Or install individual extensions permanently:

pi install npm:@arhen/pi-core-subagent

Try one without adding it permanently:

pi -e npm:@arhen/pi-core-vision

Important

Pi extensions run with your full user permissions. Review an extension before installing it from any third party.

📦 Core extensions

Package	Use it for
@arhen/pi-core-ask	Structured up-to-4-question questionnaire tool
@arhen/pi-core-skill-tool	Skills catalog, lazy skill tool
@arhen/pi-core-subagent	Fast in-process subagents, dependency scheduler
@arhen/pi-core-todo	Flat/nested todos, direct-child progress, bounded tree UI + blockedBy
@arhen/pi-core-tps-stats	Live tokens-per-second stats
@arhen/pi-core-vision	Vision fallback for text-only models

🧩 Add-on extensions

Package	Purpose for
@arhen/pi-add-9router	9router provider registration + model discovery
@arhen/pi-add-code-diagnostic	Repo-scoped typecheck/lint diagnostics
@arhen/pi-add-commandcode	Command Code Provider API: 58 models, dual-endpoint routing, ZDR
@arhen/pi-add-mode	Named modes: instructions + tools + model + subagent model, /mode and ctrl+tab
@arhen/pi-add-vantis	Vantis integration
@arhen/pi-add-wafer	Wafer integration
@arhen/pi-senja	Haiku-style header/footer with the Gruvbox Material Senja palette

🔧 Manage the set

The toolset manages the installed extension set.

pi-toolset install   # install core set
pi-toolset add <pkg> # add an extra extension
pi-toolset update    # update installed
pi-toolset remove    # remove an extension

🛠 Development

npm install                 # hoist all workspaces
npm run check               # typecheck every package

Bump + publish a package from its workspace dir (published to the @arhen scope):

cd packages/pi-core-subagent && npm version patch && npm publish

To release a new extension: add the package under packages/core/ or packages/add/ and list it in the relevant table above.

License

MIT. Each package carries its own LICENSE and may include fork attribution.