WisentProbierz
Probierz/Docs

CLI command

probierz run

Execute one target, capture supported evidence, and analyze its report.

Invocation#

Shell
probierz run <TARGET> [ARGS]...

Options from source help#

run opts
NAME=VALUE            Environment variable given to the suite; repeatable
  --app <ID>            Application manifest whose surface and secrets apply
  --spec <FILE>         One spec file instead of the target's whole suite
  --tool <NAME>         Report shape to expect: playwright, wdio, or probierz
  --record              Keep video, traces, and screenshots for every journey
  --force               Run even when the resource this target locks is held
  --no-analyze          Skip report analysis and print the raw run
  --no-repair           Do not offer an authored repair for a failed run
  --frames <N>          Frames per second to extract from a recording
  --timeout <MS>        Give the suite this long before it is killed
  --resource-wait <MS>  Wait this long for a held resource before refusing
  --files <PATH>...     Changed files that select what runs (affected, ci)
  --host <SELECTOR>     mobile:ios:byk-auth only: the fleet host its suite
                        is placed on, from `probierz hosts`; default
                        stado:mini
  --local               mobile:ios:byk-auth only: run its suite on this
                        machine instead of the dedicated host
  --seed-resend         mobile:ios:byk-auth only: seed the login mailbox's
                        resend source and stop, running no journey

Required inputs and options#

  • `<target>` is required and is one of web | electron | mobile:ios | mobile:android | mobile:ios:byk-auth | desktop:mac | desktop:cua | desktop:win | tui.
  • `--app <appId>` selects the registered product whose manifest and source identity belong to the run.
  • `--record` requests supported video, trace, and screenshot capture; `--force` skips the preflight gate.
  • `--spec <path>` narrows execution to one spec. An absolute path may name an application-owned program in its own repository; its report records `owner: "application"`. `--frames N`, `--timeout MS`, and `--resource-wait MS` control analysis and bounded waits.
  • `--no-analyze` suppresses automatic report analysis.
  • `--local` and `--seed-resend` select the local Byk authentication path and resend its seed; both apply only to `mobile:ios:byk-auth`.
  • `--host <selector>` places `mobile:ios:byk-auth` on the selected fleet host and defaults to `stado:mini` when that target is not local.
  • Trailing `KEY=VALUE` arguments become the target process environment.

Output and state effects#

Runs the selected surface and writes the completed run and analysis as JSON. A preflight-blocked run exits 3; a completed non-passing run exits 1; only completed runs are analyzed.

Exact refusals#

  • Missing target: `run needs a target (one of …)`; unknown target: `unknown target: <target>`.
  • Unknown options, unexpected positional values, missing option values, and negative numeric options are refused by `parseRunArgs`.
  • Preflight refusal returns a structured skipped result instead of spawning the target unless `--force` is explicit.

Source snapshot#

Generated from the Rust binaries at https://github.com/wisent-ai/probierz.git revision `c589d6917201c31f57e6a7f24522c0d50ae5bd0f`.

Combined help SHA-256: `43f0d9cd136ac2c46ec3eedb2824bd5d6168f235dea4caaa50610c005f40c84a`; binary SHA-256: `7e42c843082863ed265817de90a110a2f27546426a54d372e10009fd665a4d8e`.