Skip to content

Annotate and Draw

Start a non-blocking image review:

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

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

Terminal window
usetrawsn annotate poll --session <session-id>
usetrawsn 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
usetrawsn actions video-read \
--file .usetrawsn/annotate/<session-id>/recording.webm \
--instruction "List requested changes and where they apply"

Start an editable Mermaid-based whiteboard:

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

Push a revised structure without restarting the session:

Terminal window
usetrawsn draw update --session <session-id> --init architecture-v2.mmd
usetrawsn draw poll --session <session-id>
usetrawsn 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.