pi-plan

Plan mode for pi — read-only exploration with plan-then-execute workflow

Packages

Package details

extension

Install pi-plan from npm and Pi will load the resources declared by the package manifest.

npm repohome report
$ pi install npm:pi-plan
Package
pi-plan
Version
0.1.1
Published
May 7, 2026
Downloads
120/mo · 120/wk
Author
zx06
License
MIT
Types
extension
Size
23.5 KB
Dependencies
0 dependencies · 2 peers
Pi manifest JSON
{
  "extensions": [
    "./extensions/plan"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

pi-plan

Plan mode for pi — read-only exploration and structured plan execution.

Install

pi install npm:pi-plan

Usage

Toggle plan mode

/plan

Or press Ctrl+Alt+P, or start with --plan flag:

pi --plan

Workflow

  1. Run /plan to enter read-only plan mode
  2. Ask the agent to analyze your code and create a plan
  3. The agent outputs a numbered Plan: section
  4. Choose to Execute, Stay in plan mode, or Refine
  5. During execution, progress is tracked via [DONE:n] markers
  6. Widget shows completion status in real time

Commands

Command Description
/plan Toggle plan mode
/plan:status Show current plan and progress

What gets restricted in plan mode

  • Tools: Only read, bash, grep, find, ls are available
  • Bash: Only read-only commands (cat, grep, git status, etc.)
  • Blocked: File modifications, git writes, package installs, sudo, editors

License

MIT