Command line
Every command takes -C <dir> to use a project other than the nearest sisyphus.yaml above the current folder.
sis run [paths…]
Section titled “sis run [paths…]”Run tests: files, folders, file#N for one data row; nothing for all.
| Option | |
|---|---|
-t, --tag <tag> |
Only tests with this tag (repeatable) |
--skip-tag <tag> |
Skip tests with this tag (repeatable) |
-s, --suite <name> |
A suite from sisyphus.yaml |
-w, --workers <n> |
Tests at once (desktop apps still one at a time) |
--retries <n> |
Rerun a failing test up to n times; a pass on a rerun is flaky |
--no-reuse |
Relaunch apps for every test, ignoring reuse |
--shard <i/n> |
Only slice i of n, to split a run across CI machines |
--junit <file> |
Also write a JUnit XML report |
--headed |
Show the browser |
--screenshots <when> |
never, on-failure, every-step |
--timeout <d> |
Override the step timeout, e.g. 10s |
--step-delay <d> |
Pause before each step, e.g. 500ms |
--a11y <mode> |
off, warn, strict |
--var <name=value> |
Set a variable (repeatable) |
--json · --full |
Compact or full JSON result |
Exit code 0: all passed (flaky included); 1: a test failed; 2: the run couldn’t start. Ctrl-C stops cleanly (on Windows Ctrl-Break too); twice quits at once.
Other commands
Section titled “Other commands”| Command | Does |
|---|---|
sis validate [paths…] [--json] |
Check files without running them, with line numbers |
sis list [--suites] [--json] |
Tests and flows, or suites with their test counts |
sis show [run] [--json] |
A previous result (default: latest); exit 1 if it failed |
sis stats [--last N] [--flaky] [--json] |
Flaky and slow tests over recent runs (default 50) |
sis inspect <app> | --url U | --pid N [--scope sel] [--headed] [--json] |
Print an app’s accessibility tree as selectors |
sis apps |
Running desktop apps you can inspect (macOS) |
sis load <file.load.yaml> [--json] |
Run a load test |
sis mcp |
The MCP server on stdio, for AI agents |
sis init |
Create sisyphus.yaml, an example test and .sisyphus/.gitignore |
sis setup [browsers…] |
Install or update the browser runtime and browsers (default chromium) |
sis doctor |
Check the runtime and macOS permissions |
Made by
© 2026 Bussin Bytes Ltd · sisyphus.bussinbytes.io
