Skip to main content
Plannotator opens an agent’s plan in a local review UI. Comment on exact text, mark text for removal, edit the Markdown, or add a general comment. Choose Send Feedback when the agent should revise the plan, or Approve when it can continue.

​
Open a plan review

Supported agents can open Plannotator at their plan handoff point. The exact trigger depends on the agent. Claude Code intercepts ExitPlanMode, while other agents use their own hooks, plugins, or commands. To review a plan file without an automatic hook, run:
The --gate flag adds Approve to the document annotation UI. See Agents for the setup and plan-review trigger used by each agent.

​
Review and respond

  1. Read the rendered plan.
  2. Select text to add a comment, request deletion, apply a quick label, or mark the selection as looking good.
  3. Use a global comment for feedback that does not belong to one passage.
  4. Choose Send Feedback when the plan must change before implementation.
  5. Choose Approve with Notes when the plan can proceed and the remaining feedback is non-blocking implementation guidance.
  6. Choose Approve when the plan can proceed without notes.
Some agent protocols cannot attach notes to approval. Plannotator warns before an approval would discard unsent feedback. Use Send Feedback for blocking changes.
Plannotator exports anchored feedback as structured Markdown. It includes the selected text, the comment or requested deletion, and source line information when available. Direct Markdown edits are included as a unified diff.

​
Review a revised plan

Plannotator saves each plan submission before opening the review. When the agent resubmits the same plan, a change badge shows added and removed lines. Open the diff to switch between:
  • a rendered view with added, removed, and modified blocks
  • a raw Markdown diff with + and - lines
You can annotate changed blocks in the rendered diff. Use the Version Browser to compare the current plan with an earlier saved version. See Annotations and feedback for the exact behavior of Send Feedback, Approve, Close, and Cancel. See Customize Feedback to change the returned message and Version history for local storage details. Last verified on July 31, 2026, using Plannotator product commit 7cd023c. Maintained by the Plannotator project.
Last modified on July 31, 2026