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.2.0
Published
Oct 28, 2026
Downloads
1,142/mo · 675/wk
Author
zx06
License
MIT
Types
extension
Size
29.2 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 (rendered as ✓ step n)
  6. Widget shows completion status in real time
  7. Plan messages render as expandable checklist cards

Completion is detected after the agent fully settles, so retries, compaction, and queued follow-ups do not trigger a premature "plan complete" prompt.

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.)
  • User shell: ! / !! commands are checked against the same whitelist
  • Blocked: File modifications, git writes, package installs, sudo, editors

License

MIT