Comments
Comments are for changes you'd rather describe than drag: a new color, a missing object, a behavior that's wrong. You point at what you mean, and the agent gets enough context to know exactly which thing that is.
Leave a Comment
Press C or the Comment button to enter comment mode. A playing app pauses. Then:
- click an entity to comment on it, or drag across an area, empty space included
- Shift+click adds another object to the open comment, and Shift+drag adds everything an area covers
- outside the canvas, any element of the page takes a comment, and a drag that starts on text quotes it
A comment is pinned to the 3D point you placed it at and follows the camera. With it, the agent gets the entity's path, that point and a capture of what you saw.
The comment box opens where you clicked. Enter posts and Shift+Enter adds a line. It has two buttons:
- Comment posts the comment.
- Send to Agent posts it and hands the thread to the agent, which reads it, does the work and replies in the thread without you typing anything in the session. Writing
@agentin the text does the same.
Comment mode stays on until Done commenting, C, or a second Esc. The first Esc closes an open draft.
A comment or reply can carry up to 4 reference images. Paste them into its box, drop them onto it, or pick them with its image button. The agent reads them with the thread.
Follow a Thread
A thread sent to the agent shows where it is:
| Status | Meaning |
|---|---|
| Queued for an agent session | No session has picked it up yet |
| Working on it… | The agent has received it |
| Hasn't replied yet | No reply within 10 minutes |
The sidebar lists every thread. Drag its left edge to resize it, or double-click the edge to reset it.
Deleting a thread while it is Working on it… or Hasn't replied yet withdraws it: the agent is told to drop the request, revert the changes it made for it, and not reply. A thread deleted while it is still queued never reaches the agent.
Who Is Watching
Comments reach only the sessions linked to the stage: a session that opened the stage, or one you paste the stage's URL into. The circle at the right of the header shows who is there:
| Circle | Meaning |
|---|---|
| Green, Agent is watching | Comments reach the agent straight away |
| Amber | A linked session is open but not watching; comments arrive with your next message there |
| Hollow, No agent session | Comments you send wait until a session links the stage |
How a session hears about new comments depends on the agent. See Claude Code and Codex.