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.
• 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.

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 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 300k 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/PowerShell commands and protected write/edit targets like .git, node_modules, and secret-bearing .env files.

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.