Skip to content

Commands and flags

Run dyno for headless tests, dyno --ui to inspect the app, or dyno --manual to open the test URL yourself. Add --watch to rerun edits.

The help below comes from the CLI itself. Use dyno <command> --help in your terminal to see the same options.

dyno

Section titled “dyno”
Usage: dyno [options] [command]


Run acceptance tests in the browser, from a URL.


Options:
  -v, --version      Print the installed version
  --json             Write JSON events to stdout and diagnostics to stderr
  -h, --help         display help for command


Commands:
  run [options]      Run tests (the default command)
  init               Create a config and example test without overwriting
                     existing files
  doctor [options]   Check tests, app configuration, and browser prerequisites
                     without launching
  browsers           List installed Playwright browser builds
  install [options]  Download a Playwright browser build
  help [command]     display help for command


Examples:
  dyno                         Run tests headlessly
  dyno --ui --watch            Inspect the app and rerun edits
  dyno doctor                  Check configuration and browser setup
  dyno run --help              See test filters and run options


Tests, actions, and assertions execute in the browser. Use --manual for Safari and other browsers.

dyno run

Section titled “dyno run”
Usage: dyno run [options]


Run tests (the default command)


Options:
  -c, --config <path>    Configuration file (dyno.config.js)
  --browser <name>       Browser for the test run (choices: "chromium",
                         "firefox", "webkit", "chrome", "edge")
  --browser-path <path>  Path to a compatible browser executable
  --ui                   Visible-browser mode
  --manual               URL-only mode without a browser launcher
  --repeat <number>      Repeat the complete selection; seeded rounds vary
                         reproducibly (headless only)
  --workers <number>     Isolated browser workers (1); concurrent runs require
                         project worker setup
  --replay <path>        Replay recorded worker queues from schedule.json
  --seed <value>         Run in a repeatable randomized order
  --random               Generate and print a seed for this run
  --watch                Rerun when tests or imported helpers change
  --test <name>          Exact test name or suite-qualified title
  --id <id>              Stable test ID; repeat to select several
  --file <path>          Test file or filename; repeat to select several
  --suite <name>         Suite and descendants; repeat to select several
  --host <address>       Gateway address (127.0.0.1); use 0.0.0.0 for other
                         devices
  --port <number>        Gateway port (7357); 0 chooses an available port
  --report-dir <path>    Saved JSON, JUnit, and HTML reports (.dyno/reports)
  -h, --help             display help for command


Global Options:
  -v, --version          Print the installed version
  --json                 Write JSON events to stdout and diagnostics to stderr


Examples:
  dyno --test 'saves a contact'
  dyno run --suite Authentication --file login.test.js
  dyno --manual --host 0.0.0.0
  dyno --browser webkit


--ui, --manual, and --watch keep the runner open. Press Ctrl-C to stop.

dyno init

Section titled “dyno init”
Usage: dyno init [options]


Create a config and example test without overwriting existing files


Options:
  -h, --help     display help for command


Global Options:
  -v, --version  Print the installed version
  --json         Write JSON events to stdout and diagnostics to stderr

dyno doctor

Section titled “dyno doctor”
Usage: dyno doctor [options]


Check tests, app configuration, and browser prerequisites without launching


Options:
  -c, --config <path>    Configuration file (dyno.config.js)
  --browser <name>       Browser for the test run (choices: "chromium",
                         "firefox", "webkit", "chrome", "edge")
  --browser-path <path>  Path to a compatible browser executable
  --ui                   Visible-browser mode
  --manual               URL-only mode without a browser launcher
  -h, --help             display help for command


Global Options:
  -v, --version          Print the installed version
  --json                 Write JSON events to stdout and diagnostics to stderr


Use --ui to check a visible-browser setup, or --manual for URL-only execution.

dyno browsers

Section titled “dyno browsers”
Usage: dyno browsers [options]


List installed Playwright browser builds


Options:
  -h, --help     display help for command


Global Options:
  -v, --version  Print the installed version
  --json         Write JSON events to stdout and diagnostics to stderr

dyno install

Section titled “dyno install”
Usage: dyno install [options]


Download a Playwright browser build


Options:
  --with-deps       Also install browser system dependencies through Playwright
  --browser <name>  Engine build to download (choices: "chromium", "firefox",
                    "webkit", default: "chromium")
  -h, --help        display help for command


Global Options:
  -v, --version     Print the installed version
  --json            Write JSON events to stdout and diagnostics to stderr


Playwright Core is included. Download Chromium, Firefox, or WebKit once with this command.
Example: dyno install --browser webkit