ironflow inspect

Inspect a workflow run with the TUI debugger.

ironflow inspect <run_id> [flags]

Opens an interactive terminal UI for stepping through a completed or failed workflow run. This is a read-only viewer — it does not re-execute the workflow.

Arguments:

Argument	Required	Description
run_id	Yes	The run ID to inspect

Flags:

Flag	Type	Default	Description
--server	string		Ironflow server URL (default: IRONFLOW_SERVER_URL or http://localhost:9123)
--dap	bool	false	Start DAP server for VS Code debugging
--dap-port	int	4711	DAP server port
--at	string		Inspect run state at a specific timestamp (ISO 8601)
--replay	bool	false	Step through run events frame-by-frame
--all-events	bool	false	Include all events in replay mode (including step.started)

The time-travel modes (--at, --replay) need full recording. Set recording: true on the function (recording profile all). With a narrower profile the server refuses the request.

Only one mode runs. --at takes precedence over --replay, and both take precedence over --dap. --all-events has an effect only with --replay. --at needs an RFC 3339 timestamp, for example 2024-01-15T10:30:00Z.

TUI keys: j/k or the arrow keys move in a list. tab, h and l switch panes. n and p step forward and back. g and G go to the first and last item. b toggles a breakpoint on the current step, and c continues to the next breakpoint. ctrl+d/pgdown and ctrl+u/pgup move 10 steps in the step list. q quits.

With --at, the keys are j/k, tab and q. With --replay, left/h and right/l move between frames, g and G go to the first and last frame, j/k and tab work as above, and q quits.

Examples:

# Interactive TUI debugger
ironflow inspect run_abc123

# DAP mode for VS Code
ironflow inspect run_abc123 --dap

# Custom server
ironflow inspect run_abc123 --server http://prod-server:9123

# Time-travel: inspect run state at a specific point in time
ironflow inspect run_abc123 --at "2024-01-15T10:30:00Z"

# Time-travel: step through events frame-by-frame (DVR replay)
ironflow inspect run_abc123 --replay

# Time-travel: replay with all events including step.started
ironflow inspect run_abc123 --replay --all-events

---