@firstpick/pi-extension-plan-executor

Autonomous PLAN.md execution loop for Pi that continues until all checklist items are complete.

Packages

Package details

extension

Install @firstpick/pi-extension-plan-executor from npm and Pi will load the resources declared by the package manifest.

npm repohome report
$ pi install npm:@firstpick/pi-extension-plan-executor
Package
@firstpick/pi-extension-plan-executor
Version
0.2.3
Published
Aug 7, 2026
Downloads
446/mo · 195/wk
Author
firstpick
License
MIT
Types
extension
Size
20.4 KB
Dependencies
1 dependency · 1 peer
Pi manifest JSON
{
  "extensions": [
    "./index.ts"
  ]
}

Security note

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

README

Plan Executor for Pi

Works through a PLAN.md checklist and keeps going until the plan is complete or needs your input.

What you can do

  • Works through checklist items in a PLAN.md file.
  • Keeps going until the plan is complete or blocked.
  • Shows current progress and the active item.
  • Lets you stop the execution loop at any time.

Install

Install it through Pi:

pi install npm:@firstpick/pi-extension-plan-executor

Restart Pi if the package does not appear in your current session.

How to use it

Give the extension a PLAN.md file with checkboxes, then run /execute-plan. Watch progress with /plan-status and use /stop-plan whenever you want the loop to stop.

  • /execute-plan [path|topic] — start execution loop.
  • no argument: show a picker with all incomplete plans from ./PLAN.md and ~/.pi/agent/docs/*/PLAN.md; press v on a highlighted plan to preview it
  • topic argument: execute ~/.pi/agent/docs/<topic>/PLAN.md when no direct path exists
  • completed plans are marked with .plan-executor-complete and omitted from the picker
  • /stop-plan — stop active loop. Active execution can also be aborted with Esc or Ctrl+C.
  • /plan-status — show current progress.

Technical details

See TECHNICAL.md for complete commands, configuration, compatibility, security, and troubleshooting information.