CLI Flow Runner

CLI v1.0.0May 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 0 if every step and every assertion passes, 1 otherwise
  • 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