Simple Flow Builder

The Simple Flow Builder is a step-by-step workflow editor. It presents your workflow as a linear top-to-bottom list with built-in support for branching, nesting, and AI Agent sub-nodes -- all without touching the Canvas.

Same workflow, different view

Simple Flow and Canvas are two views of the same underlying workflow. You can switch between them at any time -- no data is lost. Simple Flow is ideal for straightforward, linear workflows, while Canvas is better for complex, highly-connected graphs.

Linear Top-to-Bottom Steps

In Simple Flow, every workflow is displayed as a vertical list of steps. Each step is a node, and the execution order goes from top to bottom. To add a step, click the "+" button between any two existing steps and select a node from the palette.

Drag to Reorder

Grab any step by its drag handle and move it up or down in the list. The workflow connections are automatically updated to reflect the new order. This makes it easy to restructure a workflow without manually re-wiring edges.

Branching

Simple Flow supports five types of branching nodes. When you add a branching node, the editor displays each branch as an indented block beneath the parent step:

NodeBranchesDescription
IFTrue / FalseEvaluates a condition. Steps in the True branch execute when the condition is met; steps in the False branch execute otherwise.
SwitchDynamic casesEvaluates an expression against multiple cases. Each case has its own branch. A default branch catches unmatched values.
LoopBodyIterates over a list of items. Steps in the body branch execute once per item.
Try/CatchTry / Catch / FinallySteps in the Try branch execute normally. If any step fails, execution moves to the Catch branch. The Finally branch always runs.
ParallelDynamic branchesExecutes multiple branches simultaneously. Each branch can contain any number of steps. All branches must complete before the workflow continues.

Nested Branching

Branches can contain other branching nodes, creating nested logic of arbitrary depth. For example, you can place an IF node inside the True branch of another IF node, or a Loop inside a Try/Catch. The editor renders each level with increasing indentation so the nesting structure is always clear.

Indentation depth

While there is no hard limit on nesting depth, deeply nested workflows can become difficult to read. Consider extracting complex nested logic into subflows for clarity.

AI Agent Sub-Nodes

When you add an AI Agent node in Simple Flow, it is displayed with expandable sub-node sections for memory and tools:

  • Memory (required) -- a PostgreSQL Memory sub-node is automatically added when you create an AI Agent in Simple Flow. You do not need to add or configure it manually. You can change the memory type in the sub-node configuration.
  • Tools (optional) -- click "Add Tool" to attach action nodes as agent tools. Each tool appears as an indented sub-step beneath the AI Agent.

Auto-added memory

Unlike the Canvas where you must manually connect a memory node, Simple Flow auto-adds PostgreSQL Memory as a sub-node. This eliminates the most common AI Agent setup error.

Inline Node Configuration

Click any step to expand its configuration panel inline. Simple Flow reuses the same configuration panel used in the Canvas, so you get the exact same configuration fields, validation, and expression support. The panel slides open below the step header with all available settings.

Changes made in the inline config are saved automatically, just like in the Canvas.

Auto-Save

Simple Flow auto-saves your changes automatically. A save indicator appears in the toolbar to confirm each save.

Per-Step Validation

Each step in Simple Flow shows validation status inline:

  • Valid steps -- display a subtle check indicator.
  • Invalid steps -- display an amber warning badge with a count of missing required fields.
  • Expanding an invalid step highlights the specific fields that need attention with red borders and error messages.
  • The workflow cannot be executed until all validation errors are resolved.

Step Duplication

Right-click a step (or use the step menu) and select Duplicate to create an exact copy of the step. The duplication creates a complete copy -- all configuration values, expressions, and nested sub-nodes (for branching nodes and AI Agents) are duplicated. The new step is inserted directly below the original.

Credential references preserved

Duplicated steps retain references to the same credentials as the original. No new credentials are created during duplication.

Mode Switching

Any workflow can be toggled between Simple Flow and Canvas mode using the editor toggle in the top toolbar. Switching modes does not alter the underlying workflow data -- it only changes the visual representation.

DirectionWhat Happens
Simple Flow to CanvasAll steps are laid out on the infinite canvas with automatic positioning. Branching nodes are rendered with their proper edge connections.
Canvas to Simple FlowThe workflow graph is presented as a step list. Nodes are ordered by execution order. Complex, non-linear graphs may result in a flattened representation.

Non-linear workflows

Workflows with complex, non-linear connections (e.g. merge nodes that join multiple branches) are fully supported in Canvas but may be displayed in a simplified form in Simple Flow. For these workflows, Canvas is the recommended editor.

Full Compatibility

Simple Flow and Canvas use the same underlying workflow format. Switching between editors does not affect your workflow data, execution behavior, or any integrations. Workflows created in Simple Flow can be opened and edited in Canvas (and vice versa) with no conversion step.