Origami

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

  1. Open an artifact and press Annotate at the left of the head. It reads Stop annotating while it is on.
  2. 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.
  3. 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.
  4. 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