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

The repository root is a development workspace, not a Pi package. Every extension builds into its own self-contained package under dist/<extension>, and Pi loads those packages.

Build the packages:

mise run //:build-all

Build one:

mise run //:build-ext ultra

Print the explicit package list for ~/.pi/agent/settings.json:

mise run //:settings-entries

Each entry is one local package path, e.g. ~/Workspace/pi-ext/dist/ultra. After a rebuild, restart Pi to load the updated packages.

Published npm and Git packages of the generated output are planned; until then, install from a local build.

Filtering

A generated package exposes exactly one extension entry plus its declared skills. Load a subset by listing only the wanted dist/<extension> packages. Resource filters still apply per package:

{
  "packages": [
    {
      "source": "~/Workspace/pi-ext/dist/web",
      "skills": []
    }
  ]
}

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.
• !pattern excludes.
• +path and -path force exact inclusion or exclusion.
• Filters only narrow package exports. They do not resurrect unexported junk.

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