# `mix parallel_workers`
[🔗](https://github.com/andreasronge/ptc_runner/blob/main/lib/mix/tasks/parallel_workers.ex#L1)

Run the parallel workers (LLM-orchestrated map-reduce) example.

## Usage

    # Run without tracing
    mix parallel_workers

    # Run with tracing enabled
    mix parallel_workers --trace

    # Export existing trace to Chrome DevTools format
    mix parallel_workers --export

    # View trace tree in terminal
    mix parallel_workers --tree

    # Clean up trace files
    mix parallel_workers --clean

## Options

  * `--trace` - Enable hierarchical tracing (creates .jsonl files)
  * `--export` - Export existing trace to Chrome format (.json)
  * `--tree` - Print trace tree to terminal
  * `--clean` - Delete all trace files
  * `--open` - Open Chrome DevTools trace viewer after export

## Examples

    # Full workflow: run with tracing, export, and open in Chrome
    mix parallel_workers --trace
    mix parallel_workers --export --open

    # Quick trace analysis
    mix parallel_workers --tree

## Trace Files

When tracing is enabled, files are created in `examples/parallel_workers/traces/` (gitignored):
  * `parallel_workers_trace.jsonl` - Main planner trace
  * `trace_<id>.jsonl` - One per worker (child traces)
  * `parallel_workers_trace.json` - Chrome DevTools format (after --export)

---

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