# benchweave status


Show gateway state -- polymodal (exclusive flags).


``` bash
benchweave status [OPTIONS]
```


`--data-dir` answers the LIFECYCLE question (is a daemon ours, is the hold held, where do its logs land); `--gateway` answers the LIVE question (today's REST view). Neither or both is a typed refusal (fork F1 of the supervision design record).


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


    Usage: benchweave status [OPTIONS]

      Show gateway state -- polymodal (exclusive flags).

      ``--data-dir`` answers the LIFECYCLE question (is a daemon ours, is the hold
      held, where do its logs land); ``--gateway`` answers the LIVE question
      (today's REST view). Neither or both is a typed refusal (fork F1 of the
      supervision design record).

    Options:
      --gateway TEXT   Gateway base URL, e.g. http://127.0.0.1:8123 -- today's live
                       REST view (requires --token).
      --token TEXT     Bearer token (observe tier or higher) for --gateway mode.
      --data-dir PATH  Lifecycle verdicts for this data directory (pid identity,
                       hold, log destination) -- the supervised-process view, no
                       token needed.
      --json           Emit the stable machine JSON contract instead of text.
      --help           Show this message and exit.


# Options


`--gateway: TEXT`  
Gateway base URL, e.g. http://127.0.0.1:8123 -- today's live REST view (requires `--token`). Environment variable: `BENCHWEAVE_GATEWAY`.

`--token: TEXT`  
Bearer token (observe tier or higher) for `--gateway` mode. Environment variable: `BENCHWEAVE_TOKEN`.

`--data-dir: PATH`  
Lifecycle verdicts for this data directory (pid identity, hold, log destination) -- the supervised-process view, no token needed. Environment variable: `BENCHWEAVE_DATA_DIR`.

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