pi-extensions

A collection of pi agent extensions I made. (Btw, I am also building my own harness on top of pi. Have a look if that sounds interesting!)

Subagents

• code-reviewer: Adds a code_reviewer subagent tool with read-only built-in tools plus configured MCP tools (run without confirmation, may have side effects, Pi >=1.0.4) that reviews local changes for ticket fit, diff mismatches, correctness, security, simplicity, and validation gaps without implementing fixes, auto-selects a contrarian-style opposite-provider review model when available, and clamps requested thinking to the chosen model's capabilities.
• contrarian: Adds a contrarian tool with read-only built-in tools plus configured MCP tools (run without confirmation, may have side effects, Pi >=1.0.4) that spins up an isolated subprocess to stress-test plans, designs, assumptions, bug hypotheses, and conclusions by steelmanning the strongest opposing case.
• developer: Adds a developer subagent tool that implements one task in an isolated child agent using the current session model and thinking, with read, write, edit, grep, find, ls, unrestricted bash, and configured MCP tools (run without confirmation, may have side effects, Pi >=1.0.4); write/edit are limited to the checkout.
• diff-summarizer: Adds a read-only diff_summarizer subagent tool that summarizes a diff or the current local changes and highlights review risk using the current session model at medium thinking, with read, grep, find, ls, guarded read-only bash (direct git/gh/pwd only), and configured MCP tools (run without confirmation, may have side effects, Pi >=1.0.4).
• librarian: Adds a GitHub research scout with a local repo checkout cache disabled by default under the OS user cache directory, toggleable with /librarian-cache, configurable subagent model/thinking defaults via /librarian-config, cached repos expiring after 7 days of non-use, and configured MCP tools (run without confirmation, may have side effects, Pi >=1.0.4).
• oracle: Adds an Amp-style oracle tool with read-only built-in tools plus configured MCP tools (run without confirmation, may have side effects, Pi >=1.0.4) 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.
• repo-scout: Adds a read-only repo_scout subagent tool that scans a repository and reports stack, conventions, commands, and hotspots using the current session model at medium thinking, with read, grep, find, ls, guarded read-only bash (direct git/gh/pwd only), and configured MCP tools (run without confirmation, may have side effects, Pi >=1.0.4).
• test-runner: Adds a test_runner subagent tool that runs exact validation shell commands in order in an isolated child agent using the current session model at low thinking, stops at the first failure, and reports PASS/FAIL per step; tools are unrestricted bash and configured MCP tools (run without confirmation, may have side effects, Pi >=1.0.4).
• web-scout: Adds a read-only web_scout subagent tool that researches a question on the web via the hosted Exa MCP endpoint (no API key required; optional EXA_API_KEY for higher limits) and returns citation-backed findings using the current session model at medium thinking, with web_search, fetch_url (http(s) only), read, grep, find, ls, and configured MCP tools (run without confirmation, may have side effects, Pi >=1.0.4).

Providers

• fast: Adds /fast plus the session-only /ultrafast toggle for supported direct OpenAI API, OpenAI Codex, and Anthropic Claude models; Ultrafast is limited to API-key gpt-6-astra or gpt-6.1-sol on OpenAI's canonical Responses endpoint.

UI

• git-footer: Adds TLH-style git dirty counts, ahead/behind, and optional PR number to pi's built-in footer status area. This package is standalone-only and is not auto-loaded by the @diegopetrucci/pi-extensions collection package.
• minimal-footer: Replaces pi's built-in footer with a minimal configurable two-line layout: branch plus cached git dirty/ahead/PR status and repo on the first line, context/model on the second, optional DUMB ZONE, optional xp marker, plus OpenAI Codex usage windows labeled from their reported durations.
• quiet-tools: Always renders collapsed built-in tool rows and mcp__* rows as a one-line invocation plus an expand hint without changing model-visible tool results; inspect status with /quiet-tools status.

/ Slash commands

• agent-workflow-audit: Adds /agent-workflow-audit, which runs an isolated repo workflow audit subagent with configured MCP tools (run without confirmation, may have side effects, Pi >=1.0.4) and returns only the final distilled report to the main session.
• annotate-git-diff: Adds /annotate-git-diff, a native Glimpse UI where explicit Submit sends structured feedback to the agent and close recovery keeps an unsent draft in the editor.
• annotate-last-message: Adds /annotate-last-message, a native Glimpse UI for annotating the latest assistant reply and sending planning-oriented feedback directly to the agent.
• review: Adds /review and /end-review for interactive code reviews of local changes, commits, PRs, and selected paths.
• triage-comments: Adds /triage-comments and a triage_comments subagent tool with read-only built-in tools plus configured MCP tools (run without confirmation, may have side effects, Pi >=1.0.4) 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

Context management

• context-cap: Caps effective model context windows at 350k 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.
• dynamic-context-pruning: Automatically prunes duplicate tool results, stale errored inputs, and superseded file-op outputs from long sessions behind a cache-aware net-benefit gate, with a /prune picker and /context-pruning status/control commands.

Safety

• confirm-destructive: Confirms before destructive session actions like clear, switch, and fork.
• dirty-repo-guard: Prompts before new sessions, session switches, or forks when the current git repo has uncommitted changes.
• permission-gate: Prompts for confirmation before dangerous bash commands and protected write/edit targets like .git, node_modules, and secret-bearing .env files; rejects named powershell tool calls as unsupported.

Quality of life

• brrr: Sends brrr push notifications when pi finishes an agent turn and is ready for input, with optional macOS idle gating.
• gnosis: Exposes the gn repo-local knowledge base CLI as an agent tool for searching and recording durable project decisions, constraints, and intent.
• illustrations-to-explain-things: Adds a skill for generating clean, absurd Xiaohei-style article illustrations, shot lists, image edits, and visual metaphors.
• inline-bash: Expands !{command} snippets in user prompts by running them through bash before the prompt reaches the agent.
• notify: Sends configurable terminal, desktop, bell, and sound notifications when pi finishes and is ready for input, including tmux-aware terminal notifications.
• project-mcp-json: Reads a Claude Code-style .mcp.json from the project working directory and registers the configured MCP servers with pi via pi.registerMcpServer. Requires a trusted project and follows Pi's project trust semantics — run /trust in the project to enable loading.
• todo: Adds a branch-aware todo tool for the agent and a /todos viewer for users..

Deprecated

• claude-fast: Deprecated standalone leftover. It no longer changes provider requests; use fast.
• openai-fast: Deprecated standalone leftover. It no longer changes provider requests; use fast.

Install

Full collection:

pi install npm:@diegopetrucci/pi-extensions

Or a specific extension:

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

Then reload pi:

/reload

Development

Run npm run format for the supported source and test files; CI runs npm run format:check.

The shared Glimpse implementation and declarations live in shared/glimpse/, and the canonical git footer backend lives in shared/footer/git-status.ts. Edit canonical files only, then run npm run sync:shared to update the generated package-local copies in the annotate and footer extensions. npm run sync:shared:check verifies that every allowlisted copy is present and current without writing; CI runs this check. To undo a canonical edit, restore the file under shared/glimpse/ or shared/footer/ and run the sync command again. To undo only generated output, restore the package-local copies without editing them directly. To reverse the footer extraction, restore each consumer's local backend and imports first, keep the standalone git-status.ts files and manifest entries until no consumer imports them, then remove the footer allowlist entries and canonical source; do not leave either standalone package without its runtime source.