Plan

Read-only planning mode that blocks code changes until you explicitly approve the plan.

What it does

Pi-plan enforces a two-phase workflow: investigate first, then execute. When plan mode is active, mutating tools and bash write commands are blocked. Pi can read files, search code, and reason about the problem — but it cannot make changes until you approve.

Once you review the plan and give approval, Pi exits plan mode and proceeds with implementation. The /todos command tracks plan progress as a checklist, showing which steps are complete and which are pending.

Why it's included

Agents that jump straight to implementation on complex tasks tend to make confident, hard-to-reverse mistakes. Plan mode creates a natural review checkpoint that matches how senior engineers actually work: understand the problem fully before writing a line of code. It costs nothing when you don't need it and saves significant time when you do.

Commands