A small collection of composable extensions for the Pi coding agent.
中文文档:README.zh-CN.md
Each package is independently installable and keeps its detailed behavior, configuration, examples, and tests in its own README. Every extension package also publishes a SKILL.md that Pi loads to guide agents through configuration and verification.
| Package | Description | Documentation |
|---|---|---|
pi-safety-guards |
Configurable Bash safety rules, rule actions and custom matchers. | English · 中文 |
pi-nested-skills |
Nested skill discovery, aliases and completion from configured roots. | English · 中文 |
pi-notifications |
Configurable desktop notifications for agent activity. | English · 中文 |
pi-naming |
Unified automatic and manual naming for sessions and owned terminal targets. | English · 中文 |
pi-auto-goal |
Judges every fully settled turn with a second model and continues the task in the user's voice when the agent stopped prematurely. | English · 中文 |
pi-clean-mode |
Collapses a whole agent run into a single duration header, leaving only the final answer visible until you expand it. | English · 中文 |
pi-gen-ui |
Renders json-render JSON specs as native Pi terminal panels (tables, charts, callouts, inputs) through a render_ui tool, with optional Jev-driven composition. |
English · 中文 |
pi-distill |
Compacts verbose output from every active object-schema tool before it consumes the context window. | English · 中文 |
pi-tool-supervisor |
Reviews selected tools before or after execution against matching rules, with diff-aware handling for edit and write. |
English · 中文 |
pi-metrics |
Shows a live session elapsed timer in the working spinner, then one run summary after the agent stops (on-stop, default) or one line per turn (live). |
English · 中文 |
pi-models-discovery |
Discovers models from {baseUrl}/models for providers marked with discoverModels in models.json, with a persistent startup cache and a manual refresh command. |
English · 中文 |
pi-session-tools |
Caches the full pre-filter output of bash grep/tail/head pipelines and provides session_log / session_squash for squashing long conversations with main-agent handoff summaries. |
English · 中文 |
pi-session-resources |
Collects files, browser URLs, and PR/MR links from successful tool activity and exposes them through a clickable, tabbed # resource picker above the editor. |
English · 中文 |
pi-extensions-i18n |
Provides shared locale selection, catalog loading, interpolation, and the /config:language command. |
English · 中文 |
pi-extensions-tool-display |
Provides the actual Pi tool-display host plus the shared result-rendering protocol and component helpers. | English · 中文 |
pi-model-request |
Issues a one-off model request from an extension the way Pi core does: resolves auth, adds provider session headers, and calls the completion. | English · 中文 |
@maplezzk/pi-dynamic-workflows |
Claude-Code-style dynamic workflow orchestration with meta/phase()/agent()/parallel()/pipeline() primitives, configurable via /config:workflow. Fork of michaelliv/pi-dynamic-workflows. |
English · 中文 |
@maplezzk/pi-interactive-subagents |
Non-blocking interactive subagents in multiplexer panes with live status widget, /plan and /iterate workflows. Fork of HazAT/pi-interactive-subagents. |
English · 中文 |
Extension management slash commands use the /config:<feature>[-action] convention. Legacy names remain as compatibility aliases where a command was renamed; /plan, /iterate, and /subagent are intentionally short workflow shortcuts.
Requirements: Pi with the compatible extension API and Node.js 22 or newer.
pi install git:github.com/maplezzk/pi-extensionsThe repository root is also a Pi package. Its manifest loads extension entrypoints under packages/*/index.ts while excluding library-only packages such as pi-terminal-mux and pi-model-request, so the command above installs all current extensions without trying to load shared libraries as extensions.
Reload Pi after installation:
/reload
To install a single package, use its npm package name:
pi install npm:<package-name>Most configurable extensions keep state under the Pi agent directory; exact paths, command names, environment precedence, and verification steps differ by package.
Pi loads each installed extension package's SKILL.md so an agent can follow the package-specific configuration workflow. See packages/ for configuration examples and detailed documentation.
npm install
npm run checkThe check command runs workspace type checks, tests, and the portability/i18n gates.
The repository pins https://registry.npmjs.org/ in .npmrc so lockfile tarball URLs stay portable. Installing through a mirror registry rewrites those URLs and makes npm ci fail on npm 12+ with EALLOWREMOTE; node scripts/check-lockfile-registry.mjs (part of npm run check) blocks that before merge.