sootsim test
Run package-local smoke and debugging tests, YAML flows, or the shared Detox-style conformance suites against a running sootsim target.
terminal
Options
| flag | description |
|---|---|
--flows | run YAML flows through the sootsim flow runner |
--detox | run the shared Detox-style conformance suites against sootsim |
--parallel | run discovered flows in parallel where supported |
--watch | re-run interactively when files change |
--reporter <type> | select console, json, or junit reporting |
--grep <pattern> | filter the test set by name |
Examples
terminal
Execution Modes
test multiplexes three different surfaces behind one command:
- Playwright as the default browser-facing runner
- YAML flows through
--flows - Detox-style suites through
--detox
For standalone drop-in usage, sootsim detox and sootsim maestro are the first-class commands. sootsim test --detox still works and delegates to sootsim detox under the hood.
The point is not that these runners are identical. The point is that the first command you try is always sootsim test, then you narrow the mode from there.
Practical Advice
Use this command when you want consistent project ergonomics, not when you need the last bit of harness customization. If you need an unusual orchestration path, keep using the lower-level runner directly and treat test as the common entrypoint for routine flows.