# 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 via git, pinned: ```bash pi install git:github.com/bugabinga/pi-ext@v0.0.2 ``` Default branch install: ```bash pi install git:github.com/bugabinga/pi-ext ``` Local checkout, `~` path: ```bash pi install ~/Workspace/pi-ext ``` Single-extension package filter in `~/.pi/agent/settings.json`: ```json { "packages": [ { "source": "git:github.com/bugabinga/pi-ext@v0.0.2", "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` | Pi token and spend telemetry. | [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 current session. | [README](extensions/cwd/README.md) | | `devil` | Structured `/devil` stress test against a devil's advocate and defender. | [README](extensions/devil/README.md) | | `diff-review` | Browser UI for reviewing git diffs and sending findings back to 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) | | `ghost` | Background Pi agent overlay for quick side-channel prompts. | [README](extensions/ghost/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` | Pi model and thinking telemetry. | [README](extensions/model-info/README.md) | | `neko` | Tiny animated editor cat for Pi. Pointless. Correct. | [README](extensions/neko/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) | | `prune` | Deterministic Pi session compaction with searchable recall. | [README](extensions/prune/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) | | `runtime` | Runtime detection telemetry for Pi footer/status. | [README](extensions/runtime/README.md) | | `session-rename` | Automatic short session names for Pi. | [README](extensions/session-rename/README.md) | | `ssh-tools` | SSH mode for Pi with remote read/write/edit/bash tools. | [README](extensions/ssh-tools/README.md) | | `terminal-notifier` | Terminal notification bridge for Pi completion and extension events. | [README](extensions/terminal-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) | | `usage` | Local usage statistics dashboard for Pi. | [README](extensions/usage/README.md) | | `vcs-status` | Pi workspace VCS telemetry for Git and Jujutsu. | [README](extensions/vcs-status/README.md) | | `web` | Web fetch, search, and image-analysis tools for Pi. | [README](extensions/web/README.md) | ## Resources `skills/`, `prompts/`, and `themes/` are exported by the root Pi package manifest. Install package → Pi can load those resources unless filtered out in settings. Root manifest also exports extension entrypoints through `extensions/*/index.ts`. ## 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 the workflow gods.\ Small tools drink the dark.