Skip to main content
Pi uses its own Plannotator extension. You do not need the standard Plannotator installer for this setup. The extension provides Pi’s plan tool and slash commands; it does not install Plannotator’s standalone core or extra Agent Skills.

​
Install

Pi 0.74.0 or later is required.

​
Enter plan mode

Start Pi in plan mode:
You can also run /plannotator or press Ctrl+Alt+P during a session. The command accepts an optional plan-file path. In plan mode, the agent writes a Markdown plan and calls plannotator_submit_plan. Plannotator opens the plan for approval or annotated feedback. After approval, Pi enters execution mode and tracks checklist progress.

​
Hand an approved plan to another extension

Pi uses automatic in-session execution by default. Set executionMode in the global or project config:
  1. ~/.pi/agent/plannotator.json
  2. <project>/.pi/plannotator.json
The project config overrides the global config.
After approval, external mode completes these actions in order:
  1. Restores the model, thinking level, and active tools from before planning.
  2. Returns Plannotator to idle.
  3. Emits plannotator:plan-approved with this payload:
A companion extension can listen to that Pi event and own execution. Plannotator does not enter its executing phase or track checklist progress in external mode. Tools from other extensions remain available. Plannotator disables only the tools that it enabled.

​
Manual commands

/plannotator-review uses the detected Git, GitButler, or Jujutsu provider. Pass --git or --gitbutler to force one. GitButler review requires but 0.21.0 or later on PATH.

​
Try without installing

Run pi install npm:@plannotator/pi-extension again to update the installed extension. Last verified against Plannotator OSS v0.25.1 on July 31, 2026. Maintained by the Plannotator project.
Last modified on August 9, 2026