The canvas
A canvas holds nodes side by side. Lines between nodes decide what an agent may read and which page or device it works in.
Add a node
- Click an item on the empty canvas.
- Right-click the canvas and choose New node.
- Press CtrlK and run a New command.
- Press a shortcut:
| Shortcut | Node |
|---|---|
| AltT | Terminal |
| AltC | Chat |
| AltB | Browser |
| AltN | Note |
| AltG | Group |
Double-click the canvas to add text. Drop a file on it to add the file.
Kinds of node
| Node | What it is |
|---|---|
| Terminal | A shell, or an agent CLI in its own interface. See Terminals. |
| Chat | An AI chat. See AI chats. |
| Browser | A web page. See Browsers and devices. |
| Note | Markdown. Lock to preview shows it rendered. Start agent from note opens an agent with the note as its brief. |
| Text | A label in a sans, hand or mono font. |
| File | A file of the project, in the editor. |
| Group | A frame around nodes. Drag nodes in or out, collapse it, or choose Arrange group to line them up. |
| Device | A simulator, emulator or phone. See Browsers and devices. |
| Drawing, Diagram | A drawing or diagram view. See Drawings and diagrams. |
| Routine | A routine and its latest runs. See Routines and Output. |
Right-click a node for Duplicate, Color, Open as view and Set as default size. An agent's node also has its conversation and worktree there.
Link a node to an agent
An agent reads or operates another node only over a line, or when you point at it with # in a chat.
To draw a line:
- Move the pointer to the side of a node until a dot appears.
- Drag to the other node.
Hold Shift for a straight or diagonal line. Press Esc to cancel. You can also right-click a node, choose Connect to… and click the other node.
| Line | Look | What the agent can do |
|---|---|---|
| Into an agent | Accent color, dot at the agent | Read the node at the other end: a note, file, terminal output, chat or drawing |
| Between an agent and a browser or device | Neutral, point at the page or device | Drive the page or operate the device |
| Into an agent it opened, with a task | Dashed while the task is open | See Agents working together |
Select a line to change its arrows, direction and color.
Move around
| Input | Action |
|---|---|
| Two-finger scroll, Space and drag, or middle-button drag | Pan |
| Pinch, + or - | Zoom |
| Ctrl0 | Zoom to 100% |
| Shift1 | Fit everything |
| Shift2 | Fit the selection |
| CtrlShift2 | Fit the selected node |
| Alt← and the other arrows | Select the neighboring node |
| Enter | Give the selected node the keyboard |
| Esc | Give the keyboard back to the canvas |
| CtrlAlt[, CtrlAlt] | Previous or next camera position |
The camera only moves when you move it.
Arrange nodes
| Input | Action |
|---|---|
| Drag a header | Move a node |
| Drag a handle just outside the frame | Resize a node |
| Drag across the background | Select several nodes |
| CtrlA | Select all |
| CtrlG | Group the selection |
| Backspace | Delete the selection |
| CtrlZ, CtrlShiftZ | Undo, redo |
| Hold Alt | Show handles in the gaps between nodes; dragging one moves every equal gap |
The dock
The dock under the canvas shows what waits and works, and holds zoom and locks. A lock stops panning, zooming, moving or resizing. Buttons and shortcuts still work while something is locked.
To keep an arrangement, choose Layouts, then Save layout as…. Apply a saved layout from the same menu or from the empty canvas.