Annotation types
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 withCmd/Ctrl+S. The feedback marks those changes as already applied so the agent does not repeat them. See Annotate documents 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 downloadannotations.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.