Workflows UI

Expand

The Workflows page (/workflows) provides a visual drag-and-drop editor for building multi-step automations as directed acyclic graphs (DAGs).

Workflows list

The list page shows all saved workflows with:

• Name and description
• Status badge (Draft / Active / Archived)
• Step type indicators (icons for each unique step type used)
• Marketplace badge (for workflows installed from the marketplace)
• Run / Edit / Delete / Export actions

Click New Workflow to open the builder. You can also import workflows from JSON files or install templates.

Workflow builder (/workflows/:id)

The builder is a full-screen canvas with multiple panels:

Canvas (center)

A React Flow canvas where you visually arrange and connect steps. Each node is a step; edges define execution order and data flow.

• Add step: use the step palette, context menu (right-click canvas), quick-add menu, or command palette
• Connect steps: drag from a node’s output handle to another node’s input handle
• Move: drag nodes to rearrange
• Delete: select a node and press Delete or use the selection toolbar
• Zoom: scroll wheel or pinch
• Multi-select: drag to select multiple nodes, then use the floating toolbar

Step palette (left sidebar)

Available step types organized by category:

Execution

Step	Description
Tool	Execute a shell command or built-in tool
LLM Agent	AI-powered agentic execution with Claude or other models

Logic

Step	Description
Conditional	Branch based on a condition expression (if/else)
Loop	Iterate over a collection
Parallel	Run branches concurrently

Orchestration

Step	Description
Approval Gate	Human-in-the-loop approval checkpoint
Sub-workflow	Execute a nested workflow

Inspector (right sidebar)

Click any node to open its configuration in the right sidebar. Each step type has type-specific fields.

Tool step:

• Tool selection (via tool picker modal)
• Input arguments
• Output variable mapping

LLM Agent step:

• Agent selection
• Goal / prompt text
• Input variables from previous steps
• Output mapping

Conditional step:

• Condition expression with rule builder
• True/false output paths
• Test condition modal for validation

Tip

Use {{ variable }} syntax to reference outputs from previous steps. The Step ID Picker helps you select the correct reference.

Toolbar

The workflow toolbar (top) provides:

• Save and naming
• Run / Dry Run buttons
• Undo / Redo
• Zoom controls
• Command palette (Cmd+K)
• Validation panel (shows errors/warnings)
• Documentation panel
• History panel (version history)

Running a workflow

Click Run from the list or from the builder toolbar. An execution dialog opens where you can provide run inputs. During execution, the Execution Timeline shows:

• Step-by-step execution progress with status indicators
• Input/output data for each step (via Output Preview pane)
• Errors and retry status
• Total duration

Workflow runs are viewable at /workflows/runs/:runId.

Workflows can also be triggered by the scheduler or via POST /api/workflows/{id}/run.

Templates

Click Templates to browse and install pre-built workflows. Templates can be installed with one click and customized in the builder.

Import / Export

• Export: Download a workflow as JSON for sharing or backup
• Import: Upload a previously exported workflow JSON file