# pi-ext Personal Pi extension pack: tools, footers, shell bridges, workflow hacks, small demons. ## Install Use `pi install`. Never `pi ext install`. That corpse stays buried. All extensions, pinned to repo tag: ```bash pi install git:github.com/bugabinga/pi-ext@v0.0.3 ``` Default branch: ```bash pi install git:github.com/bugabinga/pi-ext ``` Local checkout, absolute path: ```bash pi install /home/me/Workspace/pi-ext ``` Local checkout, `~` path: ```bash pi install ~/Workspace/pi-ext ``` ### Filtering Load only one extension via `~/.pi/agent/settings.json`: ```json { "packages": [ { "source": "git:github.com/bugabinga/pi-ext@v0.0.3", "extensions": ["extensions/web/index.ts"], "skills": [], "prompts": [], "themes": [] } ] } ``` Filter rules: - `extensions`: load only matching extension entrypoints. - `skills`: load only matching exported skills; `[]` loads none. - `prompts`: load only matching prompt templates; `[]` loads none. - `themes`: load only matching themes; `[]` loads none. - Omit a key to load all resources of that type exported by the package manifest. - Values are package-root paths/globs. - `!pattern` excludes. - `+path` and `-path` force exact include/exclude. - Filters narrow the root manifest. They do not resurrect junk outside it. ## Extensions | Extension slug | Short explanation | README | | ------------------ | ----------------------------------------------------------------------- | ----------------------------------------------- | | `angel` | Structured advisor and command guardrail for configured Pi model pairs. | [README](extensions/angel/README.md) | | `builtin-tools` | Toggle Pi builtin file-search tools. | [README](extensions/builtin-tools/README.md) | | `context-size` | Context-window usage telemetry for Pi. | [README](extensions/context-size/README.md) | | `cost` | Token and spend telemetry for Pi. | [README](extensions/cost/README.md) | | `ctx` | Compacts oversized Pi `read` results before they hit context. | [README](extensions/ctx/README.md) | | `cwd` | Switch Pi cwd without leaving the session. | [README](extensions/cwd/README.md) | | `devil` | Structured `/devil` command for stress-testing an idea. | [README](extensions/devil/README.md) | | `diff-review` | Browser-based git diff review bridge for Pi. | [README](extensions/diff-review/README.md) | | `fast` | OpenAI Codex priority service tier for Pi. | [README](extensions/fast/README.md) | | `footer` | Shared stable footer renderer for Pi. | [README](extensions/footer/README.md) | | `git-safe` | Hardened git clone tool for Pi. | [README](extensions/git-safe/README.md) | | `goal` | Persistent standing-goal loop for Pi sessions. | [README](extensions/goal/README.md) | | `leaks` | Provider-bound secret redaction for Pi. | [README](extensions/leaks/README.md) | | `llmiterate` | Manual editor-save bridge from comment markers to background Pi edits. | [README](extensions/llmiterate/README.md) | | `model-info` | Model and thinking telemetry for Pi. | [README](extensions/model-info/README.md) | | `neko` | Tiny animated editor cat for Pi. Pointless. Correct. | [README](extensions/neko/README.md) | | `notes` | Session-backed pending prompt notes for Pi. | [README](extensions/notes/README.md) | | `nu-bang` | Nushell bang-command bridge for Pi. | [README](extensions/nu-bang/README.md) | | `prompt-autopsy` | System-prompt autopsy command for Pi. | [README](extensions/prompt-autopsy/README.md) | | `pulse` | Living documentation sync for Pi. | [README](extensions/pulse/README.md) | | `q` | Follow-up question fork helper for Pi. | [README](extensions/q/README.md) | | `quota` | Subscription quota dashboard for Pi providers. | [README](extensions/quota/README.md) | | `shame` | Hostile agent code review for Pi. | [README](extensions/shame/README.md) | | `runtime` | Runtime detection telemetry for Pi footer/status. | [README](extensions/runtime/README.md) | | `rtk` | RTK bash command rewrite hook for Pi. | [README](extensions/rtk/README.md) | | `session-rename` | Automatic short session names for Pi. | [README](extensions/session-rename/README.md) | | `split-fork` | Fork Pi into a Ghostty split. | [README](extensions/split-fork/README.md) | | `ssh-tools` | SSH mode for Pi with remote read/write/edit/bash tools. | [README](extensions/ssh-tools/README.md) | | `the-system` | Task branches and The System skills for Pi. | [README](extensions/the-system/README.md) | | `os-notifier` | Native-first OS notifications for interactive Pi completion. | [README](extensions/os-notifier/README.md) | | `terminal-signals` | Terminal lifecycle signals for Pi. | [README](extensions/terminal-signals/README.md) | | `terse` | Terse response protocol injector for Pi. | [README](extensions/terse/README.md) | | `tldr` | Live TLDR widget above Pi editor. | [README](extensions/tldr/README.md) | | `tps` | Tokens-per-second footer segment for Pi. | [README](extensions/tps/README.md) | | `tune` | Autonomous experiment loops for tuning code with benchmarks. | [README](extensions/tune/README.md) | | `usage` | Local usage statistics dashboard for Pi. | [README](extensions/usage/README.md) | | `uv` | Route Python package tooling through `uv`. | [README](extensions/uv/README.md) | | `vcs-status` | Pi workspace VCS telemetry for Git and Jujutsu. | [README](extensions/vcs-status/README.md) | | `web` | Web fetch, search, site-map, and image-analysis tools for Pi. | [README](extensions/web/README.md) | ## Resources The root package exports extension entrypoints and extension-owned skills only. Personal skills, prompts, and themes live in global Pi config. ```json { "extensions": ["extensions/*/index.ts"], "skills": ["extensions/the-system/skills", "extensions/ultra/skills"] } ``` ## Development Clone locally, install dependencies, then point Pi at the path: ```bash git clone https://github.com/bugabinga/pi-ext.git cd pi-ext npm install pi install /home/me/Workspace/pi-ext ``` Or add to `~/.pi/agent/settings.json`: ```json { "packages": [ { "source": "/home/me/Workspace/pi-ext" } ] } ``` Useful checks: ```bash npm run typecheck npm test npm run lint npm run check ``` `npm run typecheck` runs: ```bash tsc --noEmit ``` Git installs run `npm install --omit=dev`. For local development, run `npm install` inside the repo first. ## Release model Single repo version. Tag format: ```text vX.Y.Z ``` Per-extension package versions are intentionally absent. One repo, one version. Less accounting. Fewer tiny coffins. --- Fat prompts rot in bins.\ Pi cats claw workflow gods.\ Small tools drink the dark.