Skip to content

Annotate and Draw

Start a non-blocking image review:

Terminal window
gthonragents annotate ./design.png --no-wait

Show the returned URL to the reviewer. After they click Done:

Terminal window
gthonragents annotate poll --session <session-id>
gthonragents annotate stop --session <session-id>

Image, video, and audio sessions support multiple collaborators with synchronized annotations and cursors. URL/iframe mode is single-user because its screen recording is the primary feedback artifact.

If the result contains a recording, analyze the narrated review:

Terminal window
gthonragents actions video-read \
--file .gthonragents/annotate/<session-id>/recording.webm \
--instruction "List requested changes and where they apply"

Start an editable Mermaid-based whiteboard:

Terminal window
gthonragents draw --init architecture.mmd --no-wait --port 18400

Push a revised structure without restarting the session:

Terminal window
gthonragents draw update --session <session-id> --init architecture-v2.mmd
gthonragents draw poll --session <session-id>
gthonragents draw stop --session <session-id>

Structural updates replace diagram elements while preserving human-drawn annotations. Manual positions on generated diagram elements are reset, so encode layout changes in the Mermaid source.