Docs › Artifacts
Annotations
Feedback you pin on a version of an artifact, for an agent to address in the next one.
Where Titlebar › Artifacts › Annotate
Agents use it
1 min read
How it works
- Open an artifact and press Annotate at the left of the head. It reads Stop annotating while it is on.
- Click anywhere on the artifact to drop a numbered pin, type your comment and press Enter. Shift+Enter starts a new line, and Esc cancels.
- Press a pin to read its thread, add a Reply, or take it away with Remove annotation. An agent replies there too, which is how it asks about a pin it finds unclear.
- Press the arrow beside Annotate to hand the review to a loop or an agent: see Handoff. The prompt asks the agent to read your annotations, ask about any that are unclear, and publish a new version.
Good to know
- Pins belong to the version they were made on, so a new version starts with none.
- A row in the list shows how many annotations its latest version has.
- No handoff is needed for the loop that wrote or edited the artifact: it hears of new pins by itself once it is free. Agents on the MCP server are told to check your annotations before writing a new version.
- While annotating, a click places a pin and follows no link.
Related
- ArtifactsDocuments your agents publish to Origami, drawn as they are meant to be read and kept with every version.
- HandoffHand a card, your review comments or your annotations to a loop or an agent as a ready-made prompt.
- Review threadsComments pinned to lines of a diff, which you and your agents read, answer and resolve.