pi-ext
Make Pi fit the way you work: choose tools, working modes, review flows, and session helpers. Use only the extensions you need; each README shows when it helps and how to start using it in Pi.
Install
Requires Pi 1.4.0 or later.
The repository root is a development workspace, not a Pi package.
Every extension builds into its own self-contained package under dist/<extension>.
Every build also writes dist/package.json, which lists every built package, so Pi loads the whole collection from one entry.
Build the packages:
mise run //:build-all
Build one:
mise run //:build-ext pipi
Add the collection once to ~/.pi/agent/settings.json:
{
"packages": ["~/Workspace/pi-ext/dist"]
}
After a rebuild, run /reload in Pi to load updated and newly built extensions.
At release time, a root RELEASE_NOTES.md is copied into the collection for Pi 1.5+ update notices.
No notes file means collection notices are explicitly disabled, so internal engineering history is never shown.
Published npm and Git packages of the generated output are planned; until then, install from a local build.
Filtering
The collection exposes each extension under its directory name plus its declared skills, prompts, and themes. Narrow it with package filters:
{
"packages": [
{
"source": "~/Workspace/pi-ext/dist",
"extensions": ["!voice/**"]
}
]
}
To load only a few extensions, list single dist/<extension> packages instead of the collection.
Filter rules:
extensionsselects package extension entrypoints.skillsindependently selects extension-owned skills;[]loads none.promptsandthemeswork the same way;[]loads none.- Omit a key to load every resource of that type exported by the package.
- Values are package-root paths or globs, e.g.
voice/index.tsorvoice/**. !patternexcludes.+pathand-pathforce exact inclusion or exclusion.- Filters only narrow package exports. They do not resurrect unexported junk.
Retired extensions
Relop and Ultra are no longer included.
Use PiPi for general delegation, including peer-review tasks.
Old relop and ultra settings have no effect; remove them manually if present.
Saved sessions remain history, but Relop review loops and Ultra workflows cannot be resumed through these retired extensions.
Settings
Extension settings live under the extension slug in Pi's settings.json, for example { "nushell": { "enable": true } }.
Each value resolves in this order: CLI flag, environment variable, trusted project .pi/settings.json, user ~/.pi/agent/settings.json, built-in default.
Untrusted project settings are ignored, and an invalid value warns instead of falling back to a lower source.
The Config column below shows which sources each extension accepts; its README lists the keys.
Extensions
| Extension slug | Short explanation | Config | README |
|---|---|---|---|
activity |
Session-owned terminals, background processes, file watches, and timers. | none | README |
afk |
Autonomous work with bounded background review and an animated cat. | none | README |
ask |
Answer Pi's clarifying questions with structured choices. | none | README |
bak |
Back up and restore Pi sessions across machines. | settings, env | README |
canvas |
Collaborative Excalidraw drawings in a local browser canvas. | none | README |
chrome-cdp |
Raw CDP commands, captures, and traces against extension-owned Chrome. | settings, --chrome |
README |
clipboard |
Read clipboard text or images and copy text through codemode. | none | README |
context-size |
Context-window usage telemetry. | settings, env | README |
continuity |
Continues unfinished work after context compaction. | none | README |
cost |
Token and spend telemetry. | none | README |
dilemma |
Angel investigation + Devil adversarial review backed by a configured model. | settings | README |
ephemlets |
Persistent Markdown task reports beside your conversation. | none | README |
fast |
OpenAI Codex priority service tier. | settings | README |
firefox-bidi |
Browser automation through raw Firefox WebDriver BiDi. | settings, env, --firefox |
README |
footer |
Shared stable footer renderer. | none | README |
git-safe |
Hardened Git operations and clone tooling. | settings, env | README |
good-job |
Learns from pass-through gj praise and wtf complaints. |
settings | README |
horst |
Shared config with per-host environment facts and tool deltas. | settings | README |
intellij |
Automatically registers native IntelliJ MCP for .idea projects. |
settings | README |
keysmash |
Markdown list continuation, nesting, and bracket pairing in the prompt editor. | none | README |
masks |
Switches model and thinking level together. | settings | README |
memory |
Reviewable factual memory backed by a local database. | settings, env | README |
model-info |
Executor, transport, and advisor telemetry. | none | README |
mockup |
Browser-based review of generated HTML mockups. | settings, env | README |
notes |
Session-backed pending prompt notes. | settings, env | README |
nu-bang |
Run Nushell commands directly from Pi's input. | settings, env | README |
nushell |
Let Pi work with structured shell data and persistent shell state. | settings, env, --nushell |
README |
os-notifier |
Native notifications when interactive work completes or blocks. | none | README |
pfui |
Pain-Free User Interface fallback identity and Pi context discovery. | none | README |
pipi |
Native child Pi tasks with reusable presets and optional structured output. | settings | README |
autopsy |
Inspect session history, reported usage, and captured system prompts in a browser. | none | README |
quota |
Subscription quota dashboard for supported providers. | settings, env | README |
rtk |
Rewrites eligible Bash tool calls through RTK. | settings, env | README |
runtime |
Runtime detection telemetry for footer and status. | settings, env | README |
session-rename |
Generates short session names from branch activity. | settings, env | README |
skillz |
Loads personal skills only where their conditions match. | none | README |
the-system |
Project governance through one /system command. |
none | README |
tps |
Tokens-per-second footer telemetry. | none | README |
usage |
Local usage statistics dashboard. | none | README |
vcs-status |
Git and Jujutsu workspace telemetry. | settings, env | README |
voice |
Hands-free conversations through a separately installed speech service. | settings, env | README |
web |
Web fetch, search, and site-map discovery. | settings, env | README |