@diegopetrucci/pi-extensions

A collection of pi extensions for context management, workflow audits, review-comment triage, notifications, safety guards, GitHub research, repo-local knowledge, todos, tool rendering, and model/provider helpers.

Packages

Package details

extension

Install @diegopetrucci/pi-extensions from npm and Pi will load the resources declared by the package manifest.

npm repo home report

$ pi install npm:@diegopetrucci/pi-extensions

Package: @diegopetrucci/pi-extensions
Version: 0.1.31
Published: May 20, 2026
Downloads: 2,934/mo · 1,053/wk
Author: diegopetrucci
License: MIT
Types: extension
Size: 524.1 KB
Dependencies: 0 dependencies · 4 peers

Pi manifest JSON

{
  "extensions": [
    "./extensions/agent-workflow-audit/index.ts",
    "./extensions/minimal-footer/index.ts",
    "./extensions/oracle/index.ts",
    "./extensions/context-cap/index.ts",
    "./extensions/context-inspector/index.ts",
    "./extensions/dirty-repo-guard/index.ts",
    "./extensions/gnosis/index.ts",
    "./extensions/inline-bash/index.ts",
    "./extensions/librarian/index.ts",
    "./extensions/quiet-tools/index.ts",
    "./extensions/permission-gate/index.ts",
    "./extensions/confirm-destructive/index.ts",
    "./extensions/notify/index.ts",
    "./extensions/openai-fast/index.ts",
    "./extensions/todo/index.ts",
    "./extensions/triage-comments/index.ts"
  ],
  "image": "https://raw.githubusercontent.com/diegopetrucci/pi-extensions/main/assets/oracle-preview.svg"
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

pi-extensions

A collection of pi agent extensions I made:

agent-workflow-audit: Adds /agent-workflow-audit, which runs an isolated repo workflow audit subagent and returns only the final distilled report to the main session.
confirm-destructive: Confirms before destructive session actions like clear, switch, and fork.
context-cap: Caps effective model context windows at 200k tokens by default so pi avoids the dumb zone; toggle temporarily with /context-cap.
context-inspector: Adds /context, a local self-contained HTML dashboard that breaks down where the current session context is going, with category overview, top offenders, and drilldown search.
dirty-repo-guard: Prompts before new sessions, session switches, or forks when the current git repo has uncommitted changes.
gnosis: Exposes the gn repo-local knowledge base CLI as an agent tool for searching and recording durable project decisions, constraints, and intent.
inline-bash: Expands !{command} snippets in user prompts by running them through bash before the prompt reaches the agent.
librarian: Adds a GitHub research scout with a local repo checkout cache enabled by default under the OS user cache directory, toggleable with /librarian-cache, with cached repos expiring after 30 days of non-use.
minimal-footer: Replaces pi's built-in footer with a minimal configurable two-line layout: branch/repo on the first line, context/model on the second, optional DUMB ZONE, plus OpenAI Codex 5-hour and 7-day usage when available.
notify: Sends configurable terminal, desktop, bell, and sound notifications when pi finishes and is ready for input.
openai-fast: Adds /fast to enable OpenAI Codex Fast mode for ChatGPT-auth GPT-5.4 and GPT-5.5 by injecting the priority service tier.
oracle: Adds an Amp-style read-only oracle tool that auto-selects the strongest reasoning model on the current provider/subscription, supports persisted /oracle model/thinking defaults, requests xhigh reasoning by default and clamps to model capabilities, and shows live status while running.
permission-gate: Prompts for confirmation before dangerous bash commands like rm -rf, sudo, and chmod 777.
quiet-tools: Renders collapsed built-in tool rows as a one-line invocation plus an expand hint without changing model-visible tool results; toggle temporarily with /quiet-tools.
todo: Adds a branch-aware todo tool for the agent and a /todos viewer for users.
triage-comments: Adds /triage-comments and a read-only triage_comments subagent tool that can auto-detect the current branch's PR, filter resolved/outdated inline comments, classify selected review comments with evidence, and suggest handling options without implementing changes.

(For the full list of pi extensions I use, check out my dotfiles.)

Install

Full collection:

pi install npm:@diegopetrucci/pi-extensions

Or a specific extension:

pi install npm:@diegopetrucci/pi-quiet-tools

Then reload pi:

/reload