Luigit
repositories / pi-ext

pi-ext

bugabingas pi extensions

owned by admin

README.md

Raw
Rendered preview

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:

  • 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 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
# 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:

```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/<extension>` 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) |