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
- Read the rendered plan.
- Select text to add a comment, request deletion, apply a quick label, or mark the selection as looking good.
- Use a global comment for feedback that does not belong to one passage.
- Choose Send Feedback so the agent receives the annotations and any direct edits.
- Choose Approve only when the plan can proceed without more changes.
If the plan has annotations or direct edits, use Send Feedback. Some agent protocols cannot attach feedback to approval. Plannotator warns before an approval would discard unsent feedback.
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 every feedback type, Customize Feedback to change the returned message, and Version history for local storage details.
Last verified against Plannotator OSS v0.23.1 on July 18, 2026. Maintained by the Plannotator project. 