Documentation
Everything the README leaves below the fold: the workflow spec, the two front ends, permissions, cost control, and how a run gets from your prompt to a merged diff.
Never run it before?
$ curl -fsSL steamtrain.app/install.sh | sh
$ steamtrain workflow run tour
The agentless tour runs the whole engine for $0 — no agent, no API key, no credit.
01
Workflows
What a workflow is and how to write one.
02
Pipelines
The bundled multi-stream pipeline and how edits get back to you.
mainline-pipeline.md
One prompt in, one reviewed PR out — plus the model-tier table.
worktree-lifecycle.md
How each agent step gets its own isolated git worktree.
worktree-merge-back.md
Harvesting edits: merge steps, history show --diff, history apply.
dry-run-followups.md
Trying a workflow's shape before it spends anything.
03
Surfaces
Three front ends over one runner, cache and doctor.
desktop-app.md
The Electron shell around the web UI: installing a build, how it works.
web-ui.md
The vertical pipeline visualization at 127.0.0.1:4317.
ci-headless.md
Running unattended: --approve-all, status summaries, exit codes.
detached-runs.md
workflow run --detach, attaching from any surface, the run queue.
04
Control
What a run is allowed to do, and what it asks you.
permissions.md
read-only / edit / full sandbox profiles, and the three ways they stick.
human-in-the-loop.md
Approval checkpoints, human steps, canAsk, autonomy labels.
mid-run-steering.md
Pause, edit an unrun step, resume — without restarting.
cost-and-budgets.md
Token normalization, USD pricing, maxCostUsd, workflow costs.
05
Agents & models
Wiring the CLIs and the direct APIs.