benchweave demo

Run the built-in simulator demonstration.

benchweave demo [OPTIONS]
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.