Docs/CLI Commands

run

assrt run executes one or more tests and reports the results. It accepts file paths, glob patterns, or tag filters, and exits non-zero when any test fails.

Usage

bash

assrt run [targets...] [options]

Examples

bash

# single file
assrt run tests/login.yaml

# glob
assrt run "tests/billing/**/*.yaml"

# filter by tag
assrt run --tag smoke

# headed for debugging
assrt run tests/login.yaml --headed --slow-mo 200

# kick off in the cloud, stream results back
assrt run tests/login.yaml --cloud

Options

Field	Type	Description
`--tag <tag>`	`string`	Only run tests carrying this tag. Repeatable.
`--headed`	`boolean`	Show the browser window. Useful when debugging locally.
`--slow-mo <ms>`	`number`	Inject a delay between actions to make runs easier to follow.
`--workers <n>`	`number`	How many tests to run in parallel. Defaults to CPU count.
`--var name=value`	`string`	Override a variable for this run. Repeatable.
`--cloud`	`boolean`	Run on Assrt Cloud and stream results to the terminal.
`--reporter <name>`	`string`	Override the configured reporter (cli, junit, html, json).