> ## 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.

# CLI Reference

> Complete reference for the Replay CLI.

# CLI Reference

Replay is a single binary with four commands:

| Command           | Description                                   |
| ----------------- | --------------------------------------------- |
| `replay run`      | Execute one or more workflow files            |
| `replay validate` | Validate a workflow file without executing it |
| `replay watch`    | Watch workflow files and re-run on changes    |
| `replay version`  | Print version information                     |

## Global Flags

| Flag      | Alias | Default | Description                                     |
| --------- | ----- | ------- | ----------------------------------------------- |
| `--debug` | `-d`  | `false` | Enable debug logging for HTTP and other runners |

## Usage Pattern

```bash theme={null}
replay [command] <files...> [flags]
```

## Quick Reference

```bash theme={null}
# Run a single workflow
replay run workflow.yaml

# Run multiple workflows in parallel
replay run workflows/*.yaml --concurrency 4

# Stop on first failure
replay run test.yaml --fail-fast

# Use a config profile
replay run test.yaml --profile staging

# Validate a workflow
replay validate workflow.yaml

# Watch for changes and re-run
replay watch workflow.yaml --debounce 300ms

# Print version
replay version
```

## Schema Annotation

For IDE autocomplete, add the schema reference to your YAML files:

```yaml theme={null}
# yaml-language-server: $schema=https://raw.githubusercontent.com/tomiwa-a/replay/main/schema.json
```