pi-extensions

Custom extensions for pi-coding-agent.

Extensions

Extension	Description
deep-review	Run context-pack + direct OpenAI Codex/Platform deep review with live streaming UI
pi-env-guard	Keep secrets out of the agent's bash commands, with refill for nested Pi
pi-ghostty-hunk	Open Hunk in a new Ghostty window at the current repo root
pi-ghostty-lazygit	Open lazygit in a new Ghostty window at the current repo root
pi-jobs	Scheduled agent jobs in a Pi Durable daemon, with a /jobs overlay and inbox
pi-notify	Desktop notifications when the agent finishes
pi-quote-copy	Copy a quoted or fenced block from the last response as raw Markdown
pi-slack-user	Read Slack permalinks and post confirmed replies with a user OAuth token
pi-system-theme	Sync Pi theme with macOS dark/light mode and configurable theme names
pi-web	Web search (Exa, Brave, Claude, Codex, Google) and page fetching
plan-mode	Read-only plan mode with progress tracking and questionnaire support
pi-verbosity-control	Per-model OpenAI verbosity overrides with a keyboard toggle
the-dude	/dude board of every live Pi session, plus messages between sessions

Each extension folder contains full usage details and examples.

Install as a Pi package

pi install git:github.com/ferologics/pi-extensions

Development

Install Pi globally, then run just setup (npm installs plus the pre-commit hook) and just check from this directory. just setup also installs the pi-jobs daemon's own dependencies in pi-jobs/daemon/. TypeScript and Vitest use the installed Pi at /opt/homebrew/lib/node_modules/@earendil-works/pi-coding-agent. Local npm installs skip host-provided peer dependencies; update Pi to check compatibility with a new release.

Setup

Symlink extensions to ~/.pi/agent/extensions/:

ln -s ~/dev/pi-extensions/deep-review ~/.pi/agent/extensions/
ln -s ~/dev/pi-extensions/pi-ghostty-hunk ~/.pi/agent/extensions/
ln -s ~/dev/pi-extensions/pi-ghostty-lazygit ~/.pi/agent/extensions/
ln -s ~/dev/pi-extensions/pi-notify ~/.pi/agent/extensions/
ln -s ~/dev/pi-extensions/pi-quote-copy ~/.pi/agent/extensions/
ln -s ~/dev/pi-extensions/pi-system-theme ~/.pi/agent/extensions/
ln -s ~/dev/pi-extensions/plan-mode ~/.pi/agent/extensions/
ln -s ~/dev/pi-extensions/pi-verbosity-control ~/.pi/agent/extensions/