@diegopetrucci/pi-extensions

A collection of pi extensions, including a minimal custom footer, an Amp-style oracle, a permission gate for dangerous bash commands, confirm-before-destructive session actions, and terminal notifications when pi is ready for input.

Package details

← Back
extension

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

npm repohome report
$ pi install npm:@diegopetrucci/pi-extensions
Package
@diegopetrucci/pi-extensions
Version
0.1.13
Published
May 1, 2026
Downloads
1,021/mo · 43/wk
Author
diegopetrucci
License
MIT
Types
extension
Size
208.3 KB
Dependencies
0 dependencies · 2 peers
Pi manifest JSON
{
  "extensions": [
    "./extensions/minimal-footer/index.ts",
    "./extensions/oracle/index.ts",
    "./extensions/permission-gate/index.ts",
    "./extensions/confirm-destructive/index.ts",
    "./extensions/notify/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:

  • 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.
  • oracle: Adds an Amp-style read-only oracle tool that auto-selects the strongest reasoning model on the current provider/subscription, covers pi’s built-in providers with hardcoded rankings, sets reasoning to xhigh by default, and shows live status while running.
  • permission-gate: Prompts for confirmation before dangerous bash commands like rm -rf, sudo, and chmod 777.
  • confirm-destructive: Confirms before destructive session actions like clear, switch, and fork.
  • notify: Sends configurable terminal, desktop, bell, and sound notifications when pi finishes and is ready for input.

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

Install

Full collection:

pi install npm:@diegopetrucci/pi-extensions

Or pin the GitHub package to this release:

pi install git:github.com/diegopetrucci/pi-extensions@v0.1.13

Or a specific extension:

pi install npm:@diegopetrucci/pi-oracle

Then reload pi:

/reload