CLI Flow Runner
CLI v1.0.0•May 14, 2026
atrahasis cli includes a built-in flow runner for multi-step API tests. Define flows in JSON, run them with shared state across steps, and watch progress in a live terminal dashboard.
Run a flow
# All flows in a directory
atra run api-tests
# A specific flow
atra run api-tests -f order-lifecycle
# Sequential iterations
atra run api-tests -f order-lifecycle -i 10
# Parallel workers
atra run api-tests -f order-lifecycle -p 4
# Stop on first failure
atra run api-tests -f order-lifecycle -c
Variable resolution
Three variable types, resolved at every step:
{{flow.varName}}— flow-scoped state, carries data between steps (extract a token from login, use it in subsequent requests){{varName}}— environment variables from the active env{{random.type}}— fresh random value on each evaluation (uuid, email, name, number, custom regex, ...)
Live dashboard
- Response-time chart per step, per iteration
- Throughput, success rate, average response time
- Step-by-step table with HTTP status, latency, and assertion outcomes
- Anomaly detection highlights iterations significantly faster or slower than the step average, with a coefficient of variation summary
Details
- Exit code
0if every step and every assertion passes,1otherwise - Pre/post scripts run before/after each step (JavaScript via the boa engine)
- Same flow definition runs locally, in CI, in a release gate, or as a scheduled smoke test