# benchweave demo


Run the built-in simulator demonstration.


``` bash
benchweave demo [OPTIONS]
```


<span class="gd-details-chevron" aria-hidden="true"></span>Full --help output


    Usage: benchweave demo [OPTIONS]

      Run the built-in simulator demonstration.

    Options:
      --gateway TEXT   Drive the LIVE gateway at this base URL (e.g.
                       http://127.0.0.1:8123) instead of booting an ephemeral
                       simulation.
      --token TEXT     Bearer token for --gateway mode (control tier or higher).
                       Ignored in fresh-install mode.
      --scratch PATH   Fresh-install mode: directory for the ephemeral store
                       (created if absent; removed on exit unless --keep -- a pre-
                       existing directory itself is never deleted, only the demo's
                       store files). Fresh-install mode only -- ignored with
                       --gateway.
      --keep           Fresh-install mode: keep the scratch directory after the
                       demo. Ignored with --gateway.
      --timeout FLOAT  Seconds to wait for the demonstration run to reach a
                       terminal state.  [default: 120.0]
      --fixtures PATH  Fixture lattice directory (default: the repository
                       execution lattice).
      --json           Emit the stable machine JSON contract instead of text.
      --help           Show this message and exit.


# Options


`--gateway: TEXT`  
Drive the LIVE gateway at this base URL (e.g. http://127.0.0.1:8123) instead of booting an ephemeral simulation. Environment variable: `BENCHWEAVE_GATEWAY`.

`--token: TEXT`  
Bearer token for `--gateway` mode (control tier or higher). Ignored in fresh-install mode. Environment variable: `BENCHWEAVE_TOKEN`.

`--scratch: PATH`  
Fresh-install mode: directory for the ephemeral store (created if absent; removed on exit unless `--keep` -- a pre-existing directory itself is never deleted, only the demo's store files). Fresh-install mode only -- ignored with `--gateway`.

`--keep`  
Fresh-install mode: keep the scratch directory after the demo. Ignored with `--gateway`.

`--timeout: FLOAT = 120.0`  
Seconds to wait for the demonstration run to reach a terminal state.

`--fixtures: PATH`  
Fixture lattice directory (default: the repository execution lattice). Environment variable: `BENCHWEAVE_FIXTURES`.

`--json`  
Emit the stable machine JSON contract instead of text.