Skip to documentation
AgentDocksDocumentation

Node Editor

Canvas basics

The Node Editor is a canvas of nodes joined by wires. This page covers getting around it: adding, wiring, selecting, the tools, the keys, undo and saving.

Last reviewed October 25, 2026

What is on the screen

The palette sits on the left: every node, in collapsible groups such as Input, Generative, Tools and Automation, each group with a colour dot. A search box at the top finds a node by name. The canvas fills the rest, with a small toolbar for the tools, a control for zoom, fit and wire style, and a minimap. The bar at the top holds the project name, the run controls and the save state.

Build a first chain

  1. 1

    Add a node

    Press a tile in the palette, or drag it onto the canvas where you want it. Search when you know the name.
  2. 2

    Wire two nodes

    Drag from an output port on the right of one node to an input port on the left of another. A port only accepts a wire it can use; the others do not light up.
  3. 3

    Move and arrange

    Drag a node by its header. Box Select or drag on the empty canvas to select several, then move them together.
  4. 4

    Run and look

    Press Run on a generator and watch the result land in the preview wired to it.

Expected result

A short chain, an input into a generator into a preview, with the wire taking the colour of the node that feeds it.

Wires and port colours

A port is painted by where its data comes from, never by a fixed table. An output port carries its own node's group colour. An unwired input is neutral. A wired input, and the wire itself, take the colour of whatever feeds them, so a prompt port fed by a Describer turns the Tools yellow and one fed by a Text Input stays the Input colour. The colour tells you where a value came from without tracing the wire.

What can connect
Ports have kinds: text, image, video, document, attachments, trigger and collection. A wire is allowed when the kinds fit, and the editor refuses the rest before you drop.
One wire or many
Most inputs hold one wire; dropping a new one replaces it. Attachment ports take several, and Image Bulk's One by one is the amber collection wire that only a Batch Run accepts.
Cutting wires
Press C for the Wire Cutter and drag across the wires to remove, or select a wire and press Delete.
Connect to…
With nodes selected, the selection bar offers Connect to, which suggests the nodes that can take the selection's output.

A data wire is not a run order

Wires carry data, not the order of work. A generator downstream does not start because the one before it finished, unless its trigger port is wired. Run workflows explains the difference.

Tools and keys

KeysWhat it does
⌘ ZUndo. Shift ⌘ Z redoes.
⌘ C, ⌘ X, ⌘ VCopy, cut and paste nodes, including between tabs. Highlighted text inside a node is copied instead of the node.
⌘ DDuplicate the selection.
Delete or BackspaceRemove the selected nodes and wires.
FConnect the two selected nodes, when a wire between them is possible.
⌘ 0, ⌘ =, ⌘ -Reset, zoom in, zoom out.
V, H, BMove, Hand and Box Select tools. Escape returns to Hand.
CWire Cutter: drag across wires to remove them.
S, T, R, O, L, ASticky Note, Text, Rectangle, Ellipse, Line and Arrow, for marking up the canvas.

On Windows, Ctrl stands in for ⌘. The markup tools, notes, text, shapes, lines and arrows, draw on the canvas without touching the workflow; use them to explain a board to whoever opens it next.

Undo takes back what you did

Every durable edit is one undo step: adding, moving, wiring, deleting, changing a setting, replacing a picture. A drag is one step, not a hundred. What Undo never touches is the machine finishing work you already committed to: a generation landing or an upload completing changes the document but does not enter the history, because undoing a paid result would not give the credits back.

Saving is automatic

The canvas saves itself after every durable edit. The top bar shows Saving while a write is in flight, and Not saved if one failed, until the next succeeds. Signed out, it reads Sign in to save: you can try the editor, but nothing is kept. The camera position is remembered per device, so a project opens where you left it.

Next: run one node, a chain, or the whole workflow