Documentation

CLI reference

The CLI is the reproducibility and automation interface behind the local browser product. Use `structtrace --help` and each subcommand's help for the exact installed version.

CommandPurpose
structtrace openStart the capability-protected local browser product.
structtrace initCreate a project from a template, preset, or existing output files.
structtrace runExecute or load both variants and finalize paired evidence.
structtrace reportServe, open, or export a verified completed report.
structtrace gateEvaluate the configured advisory, regression, or release gate.
structtrace replayVerify and recompute retained evidence without rerunning variants.
structtrace runsList, inspect, archive, and deliberately delete inactive runs.
structtrace doctorCheck configuration and environment with explicit side-effect levels.
structtrace demoRun bundled invoice, support-ticket, or accepted-research fixtures.

Project selection

structtrace --project-root ./my-project run
structtrace --project-root ./my-project report latest --open

Run selectors

latest resolves only completed production runs. Bundled fixtures are isolated behind latest-demo, latest-research, and latest-any.

Machine-readable output

Commands that support structured output expose their exact options in --help. CI gate mode can emit annotations and a metrics table while retaining the stable process exit code.

Versioned reference

For every flag and configuration field, use the configuration reference and the installed binary's help. The website intentionally does not duplicate unstable flags.