Skip to main content
Workflows in Burgundy are defined in .lobsterX format and orchestrated by the Convex workflow engine. The dashboard provides tools for building, launching, monitoring, and managing the full lifecycle.

​
Workflow Catalog

The catalog page (/workflows/convex) lists all workflow definitions. Each card shows status, tags, active run count, and deployment info.
ActionHow
FilterBy status (active, draft, paused, deprecated), by tag, or by search text
SortLast modified, name, most runs, highest cost, most failures, recently run
PinStar frequently-used workflows for quick access at the top of the catalog

​
Visual Builder

The builder (/workflows/convex/builder) is a dual-mode editor for .lobsterX definitions.

Builder Components

DAG Canvas

ReactFlow directed graph. Drag steps from the palette, connect dependencies, auto-layout via Dagre

Step Library

Pre-built snippets organized by category: Research, Analysis, Approval, Communication, Utility

Property Editor

Configure step ID, command, role, phase, timeout, failure policy, conditions, and outputs

Validation Panel

Real-time error and warning display. Click an error to select the offending node

Switch to YAML mode for direct editing with syntax highlighting and continuous schema validation. The builder serializes between visual and YAML representations; invalid YAML prevents switching to visual mode.

​
Launch a Run

1

Select workflow

Choose from the catalog or open from a workflow detail page.
2

Choose gateway

Pick a registered gateway. Each shows name and health status.
3

Configure inputs

If the workflow defines typed args, fill in auto-generated form fields. Otherwise, provide raw JSON. Optionally attach documents.
4

Set execution mode

Select prescriptive (step-by-step) or delegated (agent-directed).
5

Start

Click Start Run. The run detail page opens immediately with live status.

​
Run Detail

The run detail page (/workflows/convex/[runId]) is a multi-tab view with an always-visible sidebar showing run status, step list, pending approvals, and accumulated cost.
TabWhat it shows
Flow (DAG)Live DAG visualization with step status (pending/running/completed/failed/skipped). SSE-powered optimistic updates — nodes change before the Convex round-trip confirms.
TimelineGantt chart showing step execution timing. HITL gates appear as diamond markers showing approval wait duration.
LogsMerged chronological view combining audit events, token usage, SSE events, and interpreter warnings. Level filtering and text search.
ArtifactsPhase-grouped step outputs with collapsible JSON trees, downloadable files, stdout content, and error stack traces.
CostToken usage and cost breakdown per step. Summary cards, cost-by-step bar chart, model usage pie chart, and detailed token table.

​
Run Actions

From the run detail page, you can:
  • Cancel a running workflow (stops all pending steps)
  • Restart from a failed step (re-executes from the failure point)
  • Rewind to a checkpoint (rolls back to a prior state)
  • Branch from a checkpoint with modified inputs (creates a new run diverging from that point)
How it works: See Checkpoints for how rewind and branch work under the hood. →

​
Version Management

Access version history from the workflow card’s action menu or the detail page. You can:
  • View all versions newest-first with step counts, notes, author, and timestamp
  • Compare any two versions with a side-by-side diff (green additions, red removals)
  • Roll back to a previous version (creates a new version from the historical content)