CLI
Probierz CLI command reference.
Every public Probierz command has one canonical page. Nested command groups keep their slash-separated route, and every page records the exact invocation, inputs, effects, and fail-closed behavior exposed by the installed Rust binary.
Command tree#
Choose a command below. Group entries document the dispatcher boundary; indented arrow labels are runnable leaf subcommands.
Source snapshot#
This reference is generated from the Rust binaries at https://github.com/wisent-ai/probierz.git revision `f40fa7ed94a028b56b5a59342eaf55982ba5cf7d`, not an unpinned latest checkout.
The captured binary reports `probierz 0.1.0` and contains 65 source-bound command invocations. Combined help SHA-256: `04bab0ac1e9691119efcb70627b534a73431f51bb44ed8ba81d93cc10afd6569`; binary SHA-256: `08424ee2465261eafaa112d13ef05a20ce1fe1b6479e896341e22fbc55e61d3e`.
Discovery and product status#
- probierz list — List every supported test surface together with its package, tool, scripts, targets, and required environment coordinates.
- probierz apps — List registered products, their targets, and declared journeys.
- probierz app — Load and print one validated Probierz application manifest.
- probierz source-identity — Compute the exact Probierz harness and application source identity used to bind evidence to code.
- probierz specs — Discover spec files currently present on disk, optionally for one surface.
- probierz describe — Statically extract the `describe` and test titles from a spec file.
- probierz cmd — Print the exact shell command registered for one execution target without running it.
- probierz accessibility — Validate stable accessibility IDs, native selectors, and selector references for a registered application.
- probierz history — Read stability history by run, journey, and test for an application and optional target.
- probierz dashboard — Project product, version, journey, and evidence state for one application.
- probierz status — Report journey coverage, freshness against HEAD, affected journeys, evidence levels, and pull-request merge eligibility.
- probierz hosts — List local and Stado execution hosts known to Probierz.
- probierz overview — Compose journeys, merge eligibility, repository violations, and Stado fleet health into one all-product or selected-product view.
- probierz errors — Produce the fast all-product failure view without repository violation scans.
Setup and existing definitions#
- probierz onboarding — Show the first-run journey and optionally adopt definitions from an existing Probierz repository without running them.
- probierz project — Enter the durable project-adoption command group.
- probierz project → adopt — Adopt existing Probierz application manifests and specs into the current project without executing them.
- probierz project → adoptions — List the retained source identities for previously adopted project definitions.
- probierz serve — Start Probierz's loopback API for the native desktop project-adoption surface.
Application capabilities#
- probierz apphook — Run one built-in application setup, broker, or evaluation capability named by a product manifest.
Failure intake#
- probierz failures — Read the Wisent Errors intake index, including counts by service and error code plus the newest envelopes.
- probierz intake — Enter the failure-intake command group.
- probierz intake → serve — Listen for authenticated `wisent-errors` failure envelopes from desktop applications.
- probierz incident — Enter the register of attempts that did not hold.
- probierz incident → record — Record one attempt that did not hold, with the claim in the words it was claimed in.
- probierz incident → list — Read the register, newest first, open entries by default.
- probierz incident → show — Read one register entry with its failure envelope and its resolution.
- probierz incident → resolve — Close one register entry by recording what actually repaired it.
Local execution and analysis#
- probierz check — Check whether one target's toolchain and host prerequisites are ready, and report the owner and fix for anything missing.
- probierz setup — Install the browser or Appium-driver components Probierz owns for one target, then report preflight state.
- probierz run — Execute one target, capture supported evidence, and analyze its report.
- probierz analyze — Parse a completed runner report, inventory its media, and optionally extract a frame montage.
- probierz readme-gif — Render a bounded, silent, looping GIF from one real journey recording and write its provenance sidecar.
- probierz affected — Map a git change or explicit file list to the targets it can affect.
- probierz ci — Select affected targets, run the ready targets, analyze completed runs, and return one change-driven verdict.
- probierz figure-evaluate — Render a reference and candidate figure deterministically, then obtain a rubric-scored vision verdict through the authenticated Stado model router.
- probierz seo-evaluate — Run the full crawl, indexability, structured-data, dual-model content, performance, production-evidence, and signed SEO evaluation contract.
- probierz matrix — Plan or execute an application's declared nightly or release condition matrix.
Remote Stado execution#
- probierz stado — Enter Probierz's remote Stado execution command group.
- probierz stado → run — Submit one target to a selected Stado host and return its evidence to the local `test-results` store.
- probierz stado → collect — Read an existing job's state immediately and recover its retained evidence if it is terminal.
- probierz stado → resume — Resume waiting for an existing remote job and recover its original evidence.
- probierz stado → cancel — Cancel the original Stado job and retain its cancellation record, logs, source identity, and available evidence.
- probierz stado → author — Author and verify one product-owned journey on a Stado host, then return its accepted bytes to the exact submitting checkout.
- probierz stado → seo — Execute the complete SEO evaluator on a Stado-selected dedicated host.
Evidence, security, and publication#
- probierz secret-scan — Scan an artifact directory for secrets before protected storage or publication.
- probierz audit — Read the evidence access and security audit trail with optional filters.
- probierz protect — Encrypt one run's artifact bundle at rest and optionally remove the plaintext source artifacts.
- probierz restore — Decrypt a protected evidence bundle into an explicit destination.
- probierz retention — Evaluate or apply the configured evidence-retention policy for an application.
- probierz compare — Create a deterministic diff between two recorded runs.
- probierz last-green — Find the newest passing evidence for an application, optionally narrowed by target and journey.
- probierz receipt — Validate selected evidence against exact source identities and sign one release receipt.
- probierz verify-receipt — Verify a receipt's payload hash, Ed25519 signature, trust, and optional expected public-key fingerprint.
- probierz publication — Emit an immutable verified first-use publication manifest from a signed receipt and explicit asset catalog.
- probierz publish-onboarding — Create an Echo-ingestible first-use proof manifest from one trusted passing receipt run.
Release gates#
- probierz gate-status — Read the installed pull-request and release gate enforcement state for an application.
- probierz gate-prepush — Evaluate the repository's pre-push merge gate, optionally running change-driven CI first.
- probierz gate-install — Install the managed Probierz pre-push gate into a repository while chaining one existing unmanaged hook.
- probierz gate-evaluate — Evaluate evidence against an application's pull-request or release policy without enforcing or activating the gate.
- probierz gate-enforce — Enforce an already activated pull-request or release gate against the supplied exact evidence.
- probierz gate-activate — Activate enforcement for one gate mode only after the exact current evidence evaluates green.