smithers-up

name	smithers-up
description	Start a workflow execution. Omit the workflow (or pass --interactive) to pick one interactively and monitor it in the full-screen TUI; use -d for detached (background) mode. Run `smithers up --help` for usage details.
requires_bin	smithers
command	smithers up

smithers up

Start a workflow execution. Omit the workflow (or pass --interactive) to pick one interactively and monitor it in the full-screen TUI; use -d for detached (background) mode.

Arguments

Name	Type	Required	Description
workflow	string	no	Workflow ID (from smithers workflow list) or path to a .tsx workflow file (omit with --interactive to pick one)

Options

Flag	Type	Default	Description
--detach	boolean	false	Run in background. Preflight-renders the graph first (a parse/import/graph error prints file:line:col and exits non-zero with no run created), then prints run ID/pid/logFile once the run is admitted (up to 10s)
--runId	string		Explicit run ID
--parentRunId	string		Existing run ID to record as this run's parent (persisted lineage, surfaced by inspect/ps and the MCP run tools)
--maxConcurrency	number		Maximum parallel tasks (default: 4)
--root	string		Tool sandbox root directory
--log	boolean	true	Enable NDJSON event log file output
--logDir	string		NDJSON event logs directory
--allowNetwork	boolean	false	Allow bash tool network requests
--maxOutputBytes	number		Max bytes a single tool call can return
--toolTimeoutMs	number		Max wall-clock time per tool call in ms
--hot	boolean	false	Enable hot module replacement for .tsx workflows
--input	string		Input data as JSON string
--annotations	string		Run annotations as a flat JSON object of string/number/boolean values
--resume	unknown	false	Resume a previous run. Pass true with --run-id, or pass the run ID directly (e.g. --resume )
--force	boolean	false	Resume even if still marked running
--resumeClaimOwner	string		Internal durable resume claim owner
--resumeClaimHeartbeat	number		Internal durable resume claim heartbeat
--resumeRestoreOwner	string		Internal durable resume restore owner
--resumeRestoreHeartbeat	number		Internal durable resume restore heartbeat
--serve	boolean	false	Start an HTTP server alongside the workflow
--supervise	boolean	false	Run the stale-run supervisor loop (with --serve)
--superviseDryRun	boolean	false	With --supervise, detect stale runs without resuming
--superviseInterval	string	10s	With --supervise, poll interval (e.g. 10s, 30s)
--superviseStaleThreshold	string	30s	With --supervise, stale heartbeat threshold
--superviseMaxConcurrent	number	3	With --supervise, max runs resumed per poll
--port	number	7331	HTTP server port (with --serve)
--host	string	127.0.0.1	HTTP server bind address (with --serve)
--authToken	string		Bearer token for HTTP auth (or set SMITHERS_API_KEY); required to bind a non-loopback --host
--insecure	boolean	false	Allow binding a non-loopback --host with NO auth (exposes unauthenticated approve/deny/cancel control of the run — dangerous)
--metrics	boolean	true	Expose /metrics endpoint (with --serve)
--backend	string		Bootstrap storage selection for a workflow owner or workspace Gateway; not a run-discovery/control flag
--postFailure	boolean	true	Auto-launch the post-failure autopsy workflow when this run fails (disable with --no-post-failure or SMITHERS_POST_FAILURE=0)
--verbose	boolean	false	Show engine info logs (run lifecycle, agent sessions) on interactive runs; the default keeps progress lines + warnings only. Non-TTY/structured output always gets full logs.
--report	boolean	true	On an interactive run, narrate the result with a cheap/fast agent and open an HTML summary in the browser when it finishes (disable with --no-report or SMITHERS_NO_REPORT=1).
--interactive	boolean	false	Pick a workflow and its inputs through interactive terminal prompts, then launch the full-screen TUI monitor for the run (TTY only)