> ## 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.

On Claude Code 2.1.287 or later (with the [Plannotator mod](/open-source/agents/claude-code#the-plannotator-mod)) and on [Pi](/open-source/agents/pi), the agent does not wait while you review. Your decision arrives later as a message, and a revised plan updates the same tab.

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** 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.

<Warning>
  Some agent protocols cannot attach notes to approval. Plannotator warns before an approval would discard unsent feedback. Use **Send Feedback** for blocking changes.
</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#choose-the-review-decision) for the exact behavior of Send Feedback, Approve, Close, and Cancel. See [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 on July 31, 2026, using Plannotator product commit `7cd023c`. Maintained by the Plannotator project.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.