# 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/`. Every build also writes `dist/package.json`, which lists every built package, so Pi loads the whole collection from one entry. Build the packages: ```bash mise run //:build-all ``` Build one: ```bash mise run //:build-ext pipi ``` Add the collection once to `~/.pi/agent/settings.json`: ```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: ```json { "packages": [ { "source": "~/Workspace/pi-ext/dist", "extensions": ["!voice/**"] } ] } ``` To load only a few extensions, list single `dist/` packages instead of the collection. Filter rules: - `extensions` selects package extension entrypoints. - `skills` independently selects extension-owned skills; `[]` loads none. - `prompts` and `themes` work 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.ts` or `voice/**`. - `!pattern` excludes. - `+path` and `-path` force 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](extensions/pipi/README.md) 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](extensions/activity/README.md) | | `afk` | Autonomous work with bounded background review and an animated cat. | none | [README](extensions/afk/README.md) | | `ask` | Answer Pi's clarifying questions with structured choices. | none | [README](extensions/ask/README.md) | | `bak` | Back up and restore Pi sessions across machines. | settings, env | [README](extensions/bak/README.md) | | `canvas` | Collaborative Excalidraw drawings in a local browser canvas. | none | [README](extensions/canvas/README.md) | | `chrome-cdp` | Raw CDP commands, captures, and traces against extension-owned Chrome. | settings, `--chrome` | [README](extensions/chrome-cdp/README.md) | | `clipboard` | Read clipboard text or images and copy text through codemode. | none | [README](extensions/clipboard/README.md) | | `context-size` | Context-window usage telemetry. | settings, env | [README](extensions/context-size/README.md) | | `continuity` | Continues unfinished work after context compaction. | none | [README](extensions/continuity/README.md) | | `cost` | Token and spend telemetry. | none | [README](extensions/cost/README.md) | | `dilemma` | Angel investigation + Devil adversarial review backed by a configured model. | settings | [README](extensions/dilemma/README.md) | | `ephemlets` | Persistent Markdown task reports beside your conversation. | none | [README](extensions/ephemlets/README.md) | | `fast` | OpenAI Codex priority service tier. | settings | [README](extensions/fast/README.md) | | `firefox-bidi` | Browser automation through raw Firefox WebDriver BiDi. | settings, env, `--firefox` | [README](extensions/firefox-bidi/README.md) | | `footer` | Shared stable footer renderer. | none | [README](extensions/footer/README.md) | | `git-safe` | Hardened Git operations and clone tooling. | settings, env | [README](extensions/git-safe/README.md) | | `good-job` | Learns from pass-through `gj` praise and `wtf` complaints. | settings | [README](extensions/good-job/README.md) | | `horst` | Shared config with per-host environment facts and tool deltas. | settings | [README](extensions/horst/README.md) | | `intellij` | Automatically registers native IntelliJ MCP for `.idea` projects. | settings | [README](extensions/intellij/README.md) | | `keysmash` | Markdown list continuation, nesting, and bracket pairing in the prompt editor. | none | [README](extensions/keysmash/README.md) | | `masks` | Switches model and thinking level together. | settings | [README](extensions/masks/README.md) | | `memory` | Reviewable factual memory backed by a local database. | settings, env | [README](extensions/memory/README.md) | | `model-info` | Executor, transport, and advisor telemetry. | none | [README](extensions/model-info/README.md) | | `mockup` | Browser-based review of generated HTML mockups. | settings, env | [README](extensions/mockup/README.md) | | `notes` | Session-backed pending prompt notes. | settings, env | [README](extensions/notes/README.md) | | `nu-bang` | Run Nushell commands directly from Pi's input. | settings, env | [README](extensions/nu-bang/README.md) | | `nushell` | Let Pi work with structured shell data and persistent shell state. | settings, env, `--nushell` | [README](extensions/nushell/README.md) | | `os-notifier` | Native notifications when interactive work completes or blocks. | none | [README](extensions/os-notifier/README.md) | | `pfui` | Pain-Free User Interface fallback identity and Pi context discovery. | none | [README](extensions/pfui/README.md) | | `pipi` | Native child Pi tasks with reusable presets and optional structured output. | settings | [README](extensions/pipi/README.md) | | `autopsy` | Inspect session history, reported usage, and captured system prompts in a browser. | none | [README](extensions/autopsy/README.md) | | `quota` | Subscription quota dashboard for supported providers. | settings, env | [README](extensions/quota/README.md) | | `rtk` | Rewrites eligible Bash tool calls through RTK. | settings, env | [README](extensions/rtk/README.md) | | `runtime` | Runtime detection telemetry for footer and status. | settings, env | [README](extensions/runtime/README.md) | | `session-rename` | Generates short session names from branch activity. | settings, env | [README](extensions/session-rename/README.md) | | `skillz` | Loads personal skills only where their conditions match. | none | [README](extensions/skillz/README.md) | | `the-system` | Project governance through one `/system` command. | none | [README](extensions/the-system/README.md) | | `tps` | Tokens-per-second footer telemetry. | none | [README](extensions/tps/README.md) | | `usage` | Local usage statistics dashboard. | none | [README](extensions/usage/README.md) | | `vcs-status` | Git and Jujutsu workspace telemetry. | settings, env | [README](extensions/vcs-status/README.md) | | `voice` | Hands-free conversations through a separately installed speech service. | settings, env | [README](extensions/voice/README.md) | | `web` | Web fetch, search, and site-map discovery. | settings, env | [README](extensions/web/README.md) |