pi-planner

Planner workflow extension for Pi (questioning → implementation → summary)

Package details

← Back
extension

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

npm repohome report
$ pi install npm:pi-planner
Package
pi-planner
Version
2.0.0
Published
Feb 27, 2026
Downloads
41/mo · 7/wk
Author
denzel118
License
MIT
Types
extension
Size
31.4 KB
Dependencies
0 dependencies · 2 peers
Pi manifest JSON
{
  "extensions": [
    "./extensions/planner/index.ts"
  ]
}

Security note

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

README

Pi Planner

Planner workflow extension for Pi with a strict three-phase flow:

  1. Planning (questioning + clarifications)
  2. Implementation (execute changes)
  3. Summary (final recap, no further edits)

Install

pi install npm:pi-planner

Then run:

/reload

Usage

Start planning

/plan Build a desktop-first landlord maintenance app

Planner commands

  • /plan [goal] — start planning mode
  • /plan execute — force switch to implementation mode
  • /plan status — show planner state
  • /plan doctor — diagnostics (model/tools/state)
  • /plan off — disable planner and restore default tools

What this extension does

  • In planning mode, it enforces read-only exploration and asks structured multiple-choice clarifying questions via planner_questionnaire.
  • After a plan is finalized (planner_finalize_plan), it auto-switches to implementation mode.
  • In implementation mode, it enables coding tools and nudges finder-first execution.
  • After implementation, it enters summary mode (read-only) and produces a final recap.

Notes

  • This package is a Pi package (not an npx installer).
  • Install/update/remove it with Pi package commands:
pi install npm:pi-planner
pi update
pi remove npm:pi-planner

Development

git clone https://github.com/TheDenz3l/Pi-Planner.git
cd Pi-Planner

Test locally without publishing:

pi install /absolute/path/to/Pi-Planner
/reload

License

MIT