Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.ellomas.com/llms.txt

Use this file to discover all available pages before exploring further.

replay run

Execute one or more workflow files.

Usage

replay run <workflow.yaml>... [flags]
Accepts file paths, glob patterns, or a mix of both:
replay run test.yaml
replay run tests/*.yaml
replay run auth/login.yaml db/seed.yaml

Flags

FlagAliasDefaultDescription
--concurrency-c1Number of concurrent workflow executions
--fail-fastfalseStop execution on the first failure
--profile""Config profile name (e.g., dev, staging, prod)
--config""Path to config file (default: auto-detect replay.yaml)
--debug-dfalseEnable debug logging
--max-call-depth100Maximum workflow call depth before aborting

Examples

Basic Execution

replay run workflow.yaml

Parallel Execution

# Run all workflows in the tests directory, 4 at a time
replay run tests/*.yaml --concurrency 4

# Run 3 specific workflows in parallel
replay run auth.yaml catalog.yaml checkout.yaml --concurrency 3

Fail Fast

Stop on the first failure — useful in CI to avoid wasting time:
replay run tests/*.yaml --concurrency 4 --fail-fast

Environment-Specific Runs

# Run against staging
replay run smoke-test.yaml --profile staging

# Run against production
replay run smoke-test.yaml --profile production

Debug Mode

See full request/response details for HTTP steps:
replay run workflow.yaml --debug

Exit Codes

CodeMeaning
0All workflows passed
1One or more workflows failed