@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 report
$ pi install npm:@firstpick/pi-extension-plan-executor
Package
@firstpick/pi-extension-plan-executor
Version
0.1.8
Published
May 17, 2026
Downloads
1,168/mo · 233/wk
Author
firstpick
License
MIT
Types
extension
Size
21.6 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

@firstpick/pi-extension-plan-executor

Autonomous PLAN.md checklist executor for Pi.

What it does

  • Reads markdown checklist items (- [ ] / - [x]).
  • Prompts you to choose a plan when /execute-plan is run without arguments.
  • Lets you preview the highlighted plan from the picker with v before executing it.
  • Discovers ./PLAN.md plus plan-mode archives in ~/.pi/agent/docs/<topic>/PLAN.md.
  • Keeps steering execution until unchecked items are completed.
  • Lets you abort an active executor with Esc, Ctrl+C, or /stop-plan.
  • Marks completed plans with .plan-executor-complete next to the plan file.
  • Hides completed plans from the picker.

Install

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

Configuration

No required configuration.

Commands

  • /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
    • path argument: execute that path when it exists
    • 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.

Tools

  • start_plan_executor — start autonomous plan execution for a PLAN.md checklist.
  • stop_plan_executor — stop active autonomous plan execution.
  • plan_executor_status — inspect current autonomous plan executor state.

Example view

/execute-plan
Choose a plan to execute
  workspace: PLAN.md (1/4 done)
› archive: ~/.pi/agent/docs/brave-search-setup/PLAN.md (2/5 done)
  archive: ~/.pi/agent/docs/release-workflow-cleanup/PLAN.md (0/3 done)

↑↓ navigate • enter execute • v view plan • esc/ctrl+c cancel

Preview: ~/.pi/agent/docs/brave-search-setup/PLAN.md
   1 │ # Brave Search setup
   2 │ - [x] Inspect current implementation
   3 │ - [x] Add API-key prompt
   4 │ - [ ] Run final verification

Plan executor started: ~/.pi/agent/docs/brave-search-setup/PLAN.md (Esc/Ctrl+C to abort)

Plan completed and marked done: ~/.pi/agent/docs/brave-search-setup/PLAN.md (5/5)

Use this when you already have a checklist in the workspace, or when plan mode has archived one under ~/.pi/agent/docs/<topic>/PLAN.md. Completed plans are marked and stay out of the next picker so the list stays focused on unfinished work.