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 or http://localhost:9123	Ironflow server URL
--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)

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

---