# benchweave


BenchWeave operator CLI.


``` bash
benchweave [OPTIONS] COMMAND [ARGS]...
```


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


    Usage: benchweave [OPTIONS] COMMAND [ARGS]...

      BenchWeave operator CLI.

    Options:
      --version  Show the version and exit.
      --help     Show this message and exit.

    Commands:
      backup     Snapshot the store + content into a verified backup directory.
      demo       Run the built-in simulator demonstration.
      dispose    Dispose overdue delete-tier rows through the audit trail...
      doctor     Read-only triage over one data directory (seven typed checks).
      evidence   Generate and index the retained evidence tree.
      logs       Tail the named log destination for this data directory.
      report     Render run evidence into an operator report (store at rest).
      restart    Stop then start; a stop refusal propagates (nothing starts).
      restore    Verify a backup archive and swap it in as the data directory.
      retention  Project retention/disposal from the store at rest (read-only).
      serve      Run a BenchWeave gateway locally (foreground; systemd...
      service    Service-manager surface (install renders the unit/plist).
      setup      Initialize an at-rest data directory (fresh store +...
      start      Start the gateway detached (supervised surface; stderr to...
      status     Show gateway state -- polymodal (exclusive flags).
      stop       Stop the gateway serving this data directory (the doorbell).
      ui-login   Mint a single-use browser login URL (read-only UI session).
      verify     Check manifest digests + store integrity (exit 0 iff clean).


# Options


`--version`  
Show the version and exit.


# Commands


`evidence`  
[Generate and index the retained evidence tree.](../../reference/cli/evidence.md)

`setup`  
[Initialize an at-rest data directory (fresh store + credentials).](../../reference/cli/setup.md)

`backup`  
[Snapshot the store + content into a verified backup directory.](../../reference/cli/backup.md)

`restore`  
[Verify a backup archive and swap it in as the data directory.](../../reference/cli/restore.md)

`verify`  
[Check manifest digests + store integrity (exit 0 iff clean).](../../reference/cli/verify.md)

`demo`  
[Run the built-in simulator demonstration.](../../reference/cli/demo.md)

`report`  
[Render run evidence into an operator report (store at rest).](../../reference/cli/report.md)

`retention`  
[Project retention/disposal from the store at rest (read-only).](../../reference/cli/retention.md)

`dispose`  
[Dispose overdue delete-tier rows through the audit trail (at-rest).](../../reference/cli/dispose.md)

`serve`  
[Run a BenchWeave gateway locally (foreground; systemd Type=simple).](../../reference/cli/serve.md)

`stop`  
[Stop the gateway serving this data directory (the doorbell).](../../reference/cli/stop.md)

`start`  
[Start the gateway detached (supervised surface; stderr to](../../reference/cli/start.md)

`restart`  
[Stop then start; a stop refusal propagates (nothing starts).](../../reference/cli/restart.md)

`status`  
[Show gateway state -- polymodal (exclusive flags).](../../reference/cli/status.md)

`service`  
[Service-manager surface (install renders the unit/plist).](../../reference/cli/service.md)

`doctor`  
[Read-only triage over one data directory (seven typed checks).](../../reference/cli/doctor.md)

`logs`  
[Tail the named log destination for this data directory.](../../reference/cli/logs.md)

`ui-login`  
[Mint a single-use browser login URL (read-only UI session).](../../reference/cli/ui_login.md)
