Run nodes

A run starts nodes in order. A node starts when the nodes before it are done.

Run the selected nodes

A run starts only the nodes that you select.

Select the nodes to run. To run the whole workflow, press ⌘A on Mac or Ctrl+A on Windows or Linux. This selects all nodes.
Click Run, or press ⌘↵ on Mac or Ctrl+Enter on Windows or Linux.

With no selection, Run is off. A node that you did not select passes on its current result to the selected nodes. If that node has no result yet, the run does not start. Select that node too.

Next to the button, tabletop shows the most tokens that a run of the selected nodes can use: “up to” a number of tokens. See Tokens and plans.

The Run and Step buttons with the token estimate

getting-started/run-nodes-run

Run one node

Click the node, then open the Run tab of the inspector:

Button	What it does
Run	Runs only this node.
Re-run	Runs this node again. A locked node cannot run again until you unlock it.

The Run tab of the inspector with Run, Re-run and Pause for approval

getting-started/run-nodes-run-tab

Outdated nodes

A node shows OUTDATED when you change it, or a node before it, after its last run. Its result does not match its settings and inputs now. Select the node and run it again.

Read the state of a node

Each node shows its state while it runs.

State	Meaning
Idle	The node did not run yet.
Waiting for inputs	The node waits for the nodes before it.
Queued	The node is ready and waits for its turn.
Running	The node runs now. A bar shows the progress.
Needs approval	The node is done and waits for you. See below.
Done	The node has a result. Cached means that tabletop used an earlier result with the same inputs and settings.
Failed	The node stopped with an error. Click Retry.
Cancelled	You cancelled the run. Click Retry to run the node again.
Interrupted	The run stopped before the node was done. Click Retry.

The Jobs tray lists each node run with its state and its time.

Nodes on the canvas in the states Done, Running and Waiting for inputs

getting-started/run-nodes-states

Stop a run

Click Cancel runs. Nodes that wait do not start. Nodes that run now finish and use their tokens.

Check each result before the next node

Use approval when a node costs many tokens, or when you want to check each result.

Step: click Step in place of Run. The run pauses after every node.
Pause for approval: in the Run tab of a node, turn on Pause for approval. The run pauses after each run of that node.

When a node pauses, it shows Needs approval:

Look at the result on the node.
Click Approve to go on, or Re-run to make a new result.

A node in the state Needs approval with the Approve and Re-run buttons

getting-started/run-nodes-approve

Keep a result with Lock

A locked node keeps its result. Runs and edits do not change it.

Select the node.
Click Lock on the canvas bar, or press ⌘⇧L on Mac or Ctrl+Shift+L on Windows or Linux.

To run the node again, click Unlock.

Next step

Tokens and plans.