Draw Canvas

Sketch boxes and arrows on a freeform canvas — or describe the diagram and have an AI agent draw real, editable shapes for you.

Draw is a full-window canvas for the diagrams that are faster sketched than written: an architecture, a request flow, a migration plan. Open it from the workspace switcher alongside Tasks, Notes, and Templates.

Everything on it is an ordinary editable object — boxes, arrows, labels, freehand strokes — that you can move, recolour, and resize.

Describe it and the canvas draws it

A prompt bar sits on the canvas. Type what you want and your description is handed to an installed AI CLI, which inserts real, editable shapes, arrows, and labels next to whatever you have already sketched.

a request flow from the browser through nginx to the API and Postgres, with a Redis cache beside the API

What comes back is never a flat picture. Every box and arrow can be dragged, relabelled, and recoloured afterwards — the AI gives you a first draft of the layout, not an image you have to accept.

Undo is one step

The new elements arrive selected. One Cmd+Z / Ctrl+Z, or one Delete, removes the whole generated diagram — so trying a description costs nothing, and a bad result never leaves you cleaning up thirty shapes by hand.

Choosing the agent

The gear next to the prompt bar picks which installed AI writes the diagram. Any generation can be cancelled mid-flight.

A failed generation retries itself once, and then shows you what the model actually returned rather than a generic error — usually enough to see that the agent answered in prose instead of the diagram format.

Draw or Mermaid?

  • Draw when the layout matters and you want to arrange it by hand.
  • Mermaid when the diagram should live in a .md file next to the code and be reviewed in a pull request.