> ## Documentation Index
> Fetch the complete documentation index at: https://docs.plannotator.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Review an AI Coding Plan with Plannotator

> Annotate an AI coding plan, send exact feedback to the agent, approve it, and compare the next revision.

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:

```bash theme={null}
plannotator annotate plan.md --gate
```

The `--gate` flag adds **Approve** to the document annotation UI. See [Agents](/open-source/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** so the agent receives the annotations and any direct edits.
5. Choose **Approve** only when the plan can proceed without more changes.

<Warning>
  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.
</Warning>

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](/open-source/workflows/annotations-and-feedback) for every feedback type, [Customize Feedback](/open-source/reference/custom-feedback#plan-and-document-feedback) to change the returned message, and [Version history](/open-source/workflows/version-history) for local storage details.

Last verified against Plannotator OSS v0.23.1 on July 18, 2026. Maintained by the Plannotator project.