> ## 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 workflow files with Replay.

# `replay run`

Execute one or more workflow files.

## Usage

```bash theme={null}
replay run <workflow.yaml>... [flags]
```

Accepts file paths, glob patterns, or a mix of both:

```bash theme={null}
replay run test.yaml
replay run tests/*.yaml
replay run auth/login.yaml db/seed.yaml
```

## Flags

| Flag               | Alias | Default | Description                                              |
| ------------------ | ----- | ------- | -------------------------------------------------------- |
| `--concurrency`    | `-c`  | `1`     | Number of concurrent workflow executions                 |
| `--fail-fast`      |       | `false` | Stop 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`          | `-d`  | `false` | Enable debug logging                                     |
| `--max-call-depth` |       | `100`   | Maximum workflow call depth before aborting              |

## Examples

### Basic Execution

```bash theme={null}
replay run workflow.yaml
```

### Parallel Execution

```bash theme={null}
# 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:

```bash theme={null}
replay run tests/*.yaml --concurrency 4 --fail-fast
```

### Environment-Specific Runs

```bash theme={null}
# 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:

```bash theme={null}
replay run workflow.yaml --debug
```

## Exit Codes

| Code | Meaning                      |
| ---- | ---------------------------- |
| `0`  | All workflows passed         |
| `1`  | One or more workflows failed |