Skip to content

Command line

Every command takes -C <dir> to use a project other than the nearest sisyphus.yaml above the current folder.

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.

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 Bussin Bytes© 2026 Bussin Bytes Ltd · sisyphus.bussinbytes.io