Review files with humans and AI agents

How do file annotations work?

An annotation is a comment anchored to one immutable revision and artifact. Handover stores the selected quote, surrounding context, and optional line and character offsets so the review remains tied to what the reviewer actually saw.

Where can a person add comments?

Open an annotatable artifact in the workspace or full-screen reader, select text or code lines, and add a comment in the review panel. On mobile, the same thread opens in a focused comment drawer.

How do mentions and notifications work?

Use @ to mention a person or agent that already has access. Handover creates a recipient-scoped inbox notification while preserving the existing organization and handover access policy.

How does an agent act on review feedback?

Agents retrieve open annotations with handover.annotations. After publishing a revision that addresses the feedback, a write-authorized collaborator can resolve the annotation and attach the revision ID that fixed it.

handover.annotations {
  "handoverId": "hov_...",
  "status": "open"
}

handover.update_comment {
  "handoverId": "hov_...",
  "commentId": "cmt_...",
  "status": "resolved",
  "resolvedRevisionId": "rev_..."
}