Pi Extensions

Custom extensions for Pi, a coding agent.

Warning

Feel free to use these, but they're mainly for my personal use and I might not read/merge your pr. Also, I haven't read a single line of code so I can't be held responsible if something bad happens. Godspeed ✌️

Installation

Install all extensions from this repository:

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

To install selectively (or disable specific extensions), edit your settings.json:

{
  "packages": [
    {
      "source": "git:github.com/aliou/pi-extensions",
      "extensions": [
        "extensions/processes/index.ts",
        "extensions/defaults/index.ts",
        "!extensions/the-dumb-zone/index.ts"
      ]
    }
  ]
}

Published Extensions

Standalone extensions published to npm. Install individually with pi install npm:<package>.

Extension	Description	README	npm
extension-dev	Tools and commands for developing and updating Pi extensions	README	@aliou/pi-extension-dev
guardrails	Security hooks to prevent potentially dangerous operations	README	@aliou/pi-guardrails
processes	Background process management without blocking the conversation	README	@aliou/pi-processes

All Extensions

Extension	Description	README
defaults	Sensible defaults and quality-of-life improvements	README
extension-dev	Pi extension development tools and update workflow	README
guardrails	Security hooks (brew block, env protection, dangerous command gate)	README
mac-app	macOS UI automation via Accessibility	README
neovim	Bidirectional Neovim integration (editor context, file reload, LSP diagnostics)	README
planning	Save and execute implementation plans	README
presenter	Terminal notifications, title updates, sounds	README
processes	Background process management	README
providers	Providers and usage dashboard (rate limits, session stats)	README
session-management	Session management utilities (copy path)	README
specialized-subagents	Framework for spawning specialized subagents (scout, oracle, reviewer, etc.)	README
the-dumb-zone	Context window degradation warning	README

Themes

Theme	README
jellybeans	README

Development

Uses pnpm workspaces. Nix dev environment available via flake.nix.

nix develop
pnpm install
pnpm typecheck
pnpm lint

Or as one-liners:

nix develop -c pnpm install
nix develop -c pnpm typecheck
nix develop -c pnpm lint