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

# Add Annotations and Send Feedback

> Comment on exact text, request deletions, make direct edits, attach images, and return structured feedback from Plannotator.

Select the smallest useful passage, add the requested change, then choose **Send Feedback**. Plannotator keeps the selected text with the comment so the agent can locate the issue.

## Annotation types

| Action             | Use it for                                                  |
| ------------------ | ----------------------------------------------------------- |
| **Delete**         | Mark selected text for removal.                             |
| **Comment**        | Explain a change, question, replacement, or missing detail. |
| **Quick label**    | Apply a configured label such as a test or scope reminder.  |
| **Looks good**     | Record that a selected passage needs no change.             |
| **Global comment** | Add feedback about the whole plan or document.              |

You can paste or upload an image into a comment. Plannotator stores the image as a temporary local file and includes its name and path in the feedback sent to the agent.

## Make a direct edit

Open the Markdown editor when rewriting the text is clearer than describing the change. Plannotator records added and removed lines and includes a unified diff in the feedback.

Eligible local Markdown, MDX, and text files can also be saved to disk with `Cmd/Ctrl+S`. The feedback marks those changes as already applied so the agent does not repeat them. See [Annotate documents](/open-source/workflows/documents#edit-markdown) for the write and conflict behavior.

## Check feedback before sending

Open **Export** and select **Annotations** to inspect the generated Markdown. You can copy it or download `annotations.md` without ending the review.

The exported feedback can include:

* source line labels and selected text
* comments, deletions, quick labels, and general feedback
* attached image paths
* direct-edit diffs and file changes already saved to disk
* a marker when an annotation refers to a changed block in the version diff

## Send or approve

In an agent session, **Send Feedback** returns the generated feedback to the agent. When run as a standalone CLI command, the same content is printed to stdout.

Use **Approve** only when `--gate` is active or the agent's plan workflow provides approval. If feedback is still present, send it instead of approving. Plannotator displays a warning when an agent protocol cannot carry annotations with approval.

Draft annotations and direct edits are saved under the Plannotator data directory while the session is open, so a server or browser interruption can restore them.

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