Docs

CLI Reference

The CLI exposes shared workflows across public domains, with generated coverage commands limited to domains that currently provide generation hooks.

Recommended Commands

Command

check-target

Use it for

Validate a native external HTTP target before a full run. Supported for domains with native target checks.

Command

audit

Use it for

Run one domain audit and write the standard artifact bundle.

Command

compare

Use it for

Compare baseline and candidate targets across reruns.

Command

run-swarm

Use it for

Generate coverage from one brief and run an audit where generation hooks exist today.

Command

plan-run

Use it for

Create a run_plan.json without executing the workflow.

Command

execute-plan

Use it for

Execute a saved run plan deterministically.

Command

generate-scenarios / generate-population

Use it for

Generate and save coverage packs for domains that support generated coverage.

Command

serve-reference

Use it for

Start the local product-owned reference service for supported domains.

Domain Option

Option

--domain recommender

Meaning

Recommendation slate audits, compare, generated coverage, and run-swarm.

Option

--domain search

Meaning

Search ranker audits and compare workflows.

Option

--domain agents

Meaning

Agent trajectory audits and compare workflows.

Target Options

Option

--target-url

Use it when

Running against a native external HTTP service.

Option

--driver-config-path

Use it when

Running schema-mapped HTTP, in-process imports, or agent protocol drivers.

Option

--reference-artifact-dir

Use it when

Running the local product-owned reference path where supported.

Option

--use-mock

Use it when

Internal recommender debug/testing only.