CLI for Verist workflows — replay, diff, and inspect AI decisions
npm install @verist/cli
CLI for Verist workflows — replay, diff, and inspect AI decisions.
``bash`
bun add @verist/cli
Scaffold a working project with no API keys needed.
`bash`
verist init
Creates verist.config.ts (or .mjs for Node) with a parse-contact step and sample input.
Run a step against input files and save baselines.
`bash`
verist capture --step extract --input "inputs/*.json"
verist capture --step extract --input "inputs/*.json" --label "v2-prompt"
verist capture --step extract --input "inputs/*.json" --sample 10 --seed 42
| Option | Description |
| ------------------ | -------------------------------------------- |
| --step | Step name to execute (required) |--input
| | Glob pattern for input JSON files (required) |--workflow
| | Workflow identifier (defaults to step name) |--version
| | Workflow version (defaults to "0.0.0") |--label
| | Human-readable label for the baseline |--no-commands
| | Skip capturing commands |--sample
| | Randomly sample n inputs from the glob |--seed
| | Seed for deterministic sampling (default: 0) |--meta
| | Attach metadata (repeatable) |
Recompute baselines and show diffs (exploratory).
`bash`
verist diff --step extract
verist diff --baseline .verist/baselines/extract/001.json
verist diff --step extract --format json
| Option | Description |
| ------------------- | -------------------------------------------- |
| --step | Step name to recompute |--baseline
| | Path to specific baseline file or directory |--workflow
| | Workflow identifier for auto-resolution |--version
| | Workflow version for auto-resolution |--label
| | Filter by metadata label |--format
| | Output format: text, json, or markdown |--meta
| | Filter baselines by metadata (repeatable) |
Inspect baselines and verify hash integrity.
`bash`
verist replay --step extract
verist replay --step extract --verify
verist replay --baseline .verist/baselines/ --label "v2-prompt"
Use --verify to recompute hashes and check that stored content matches.
| Option | Description |
| ------------------- | ----------------------------------------- |
| --step | Filter by step name |--baseline
| | Specific file or directory |--label
| | Filter by metadata label |--workflow
| | Workflow identifier |--version
| | Workflow version |--verify
| | Recompute hashes and check integrity |--meta
| | Filter baselines by metadata (repeatable) |
Recompute baselines and fail on regressions (CI mode).
Exit codes: 0 = clean, 1 = regressions detected, 2 = infrastructure failure.
Schema violations always trigger exit 1, independent of --no-fail-on-diff.
`bash`
verist test --step extract
verist test --step extract --no-fail-on-diff
verist test --step extract --format json
| Option | Description |
| ---------------------------- | -------------------------------------------- |
| --step | Step name to recompute |--baseline
| | Path to specific baseline file or directory |--workflow
| | Workflow identifier for auto-resolution |--version
| | Workflow version for auto-resolution |--label
| | Filter by metadata label |--format
| | Output format: text, json, or markdown |--meta
| | Filter baselines by metadata (repeatable) |--no-fail-on-diff
| | Exit 0 even when value diffs are detected |--no-fail-on-commands-diff
| | Ignore command diffs for exit code |
- --debug — show full error details--quiet` — suppress non-essential output
-