# `mix pixir.smoke.workflows_real`
[🔗](https://github.com/Ranvier-Technologies/pixir/blob/main/lib/mix/tasks/pixir.smoke.workflows_real.ex#L1)

Runs small, bounded Pixir Workflows against the real Provider.

This task is intentionally separate from `mix pixir.smoke.workflows`, which is
deterministic and no-network. Use this task only when you want live model-backed
Subagents and durable local evidence under `.pixir/`.

Usage:

    mix pixir.smoke.workflows_real --dry-run --json
    mix pixir.smoke.workflows_real --scenario micro_parallel --json
    mix pixir.smoke.workflows_real --scenario dependency --model gpt-5.3-codex-spark
    mix pixir.smoke.workflows_real --scenario writer_controlled --output .pixir/smoke/workflows-real/manual
    mix pixir.smoke.workflows_real --help

Scenarios:

  * `micro_parallel` - two read-only Subagents respond with exact constants.
  * `dependency` - two read-only Subagents feed a dependent summarizer.
  * `writer_controlled` - one writer mutates only the scratch workspace.

Options:

  * `--scenario NAME` - one of the scenarios above. Default: `micro_parallel`.
  * `--model MODEL` - optional Provider model override.
  * `--timeout-ms N` - whole-workflow timeout. Default: 90000.
  * `--step-timeout-ms N` - per-step timeout. Default: 30000.
  * `--output DIR` - durable evidence directory. Default: `.pixir/smoke/workflows-real/<run_id>`.
  * `--dry-run` - validate and print planned waves without auth, network, or writes.
  * `--json` - print machine-readable evidence or errors.
  * `--help` - print this help and exit.

# `run`

```elixir
@spec run([String.t()]) :: no_return() | :ok | {:ok, map()} | {:error, map()}
```

Entry point for the Mix task: parses CLI arguments, validates configuration, and either prints help/dry-run output or executes a real workflow run.

Parses provided `args`, handles `--help` and `--dry-run` flows, validates options, ensures authentication when performing a real run, and delegates execution to the live runner which produces durable evidence on success.

---

*Consult [api-reference.md](api-reference.md) for complete listing*