@codella/pi-plan-mode

Approval-gated plan mode extension for Pi.

Plan mode keeps Pi read-only while it explores and writes a numbered plan. The agent cannot execute mutating tools or commands until you explicitly approve the plan.

Install

pi install npm:@codella/pi-plan-mode

Commands

• /plan - Toggle plan mode.
• /plan on - Enable read-only plan mode.
• /plan off - Disable plan mode and restore previous tools.

Shortcut

• ctrl+alt+p - Toggle plan mode.

CLI flag

Start Pi in plan mode:

pi --plan

How it works

Before approval:

• Active tools are restricted to read-only tools.
• Bash commands are allowlisted to inspection commands.
• Mutating tools such as edit and write are blocked.
• The assistant is instructed to produce a numbered Plan:.

After approval:

• Previous tools are restored.
• The assistant executes only the approved plan.
• A framed progress widget shows approval state, completion percentage, the active next step, and completed steps.
• A temporary plan_progress tool is enabled so the assistant can update the task list immediately after each completed step.
• [DONE:n] markers are still recognized as a fallback.

License

MIT