--upload-results to send them to the
dashboard after the run completes. Requires tests to exist locally as YAML
files.
Arguments
array
Tests to run, given as test file paths, directories, or test-name substrings.
Defaults to every test in the current project.
Common flags
string
Path to the Momentic configuration file. Defaults to
momentic.config.yaml in
the current directory.string
Name to associate with this run, used in the dashboard and as the base
filename for generated reports.
string
Number of tests to run in parallel. Defaults to
1. Pass AUTO to
saturate the current shard.Remote runs give each test an independent emulator session, so parallelism is
safe and any org quota is enforced server-side. Local Android runs require a
distinct AVD per parallel test; running multiple tests against the same
--local-avd-id conflicts. Local iOS runs prefer parallel=1 because
concurrent Appium instances share a driver manifest.boolean
Skip all confirmation prompts. Enabled by default when
CI is set.Environment
string
Environment to run tests in. Must exist in the project configuration and takes
precedence over the default environment configured on the test.
string
Region used for remote emulator sessions. Overrides any region configured at
the project or environment level. Pass
closest to autoselect the nearest
region.string
Override the default release channel for APK selection (e.g.,
staging,
dev). When omitted, falls back to the test’s default channel, otherwise no
APK is installed on emulator initialization.string
Override the version tag within the selected channel. Accepts an exact tag,
the reserved
latest, or a floating alias (e.g. nightly). When omitted,
uses the test’s default tag, otherwise the latest uploaded APK in the channel.Filtering
array
Only run tests with one of the specified labels.
array
Only include tests whose file path matches any of the provided regex patterns.
The pattern only needs to match part of the path.
array
Exclude tests whose file path matches any of the provided regex patterns.
Video
boolean | on-fail
Record videos of mobile test runs. Accepts
true, false, or on-fail.
Defaults to on-fail (videos are recorded but kept only for failing tests).Quarantine
boolean
Skip quarantined tests entirely. By default, quarantined tests still run but
their statuses do not affect pipeline status or the process exit code.
boolean
Run only quarantined tests, applying their statuses to pipeline status and the
exit code.
boolean
Run every test even if it is quarantined. Useful for validating that
quarantined tests are fixed before moving them out of quarantine.
Caching
boolean
Disable step caches entirely. Steps run without cached data and no caches are
saved.
boolean
Always save updated step caches after successful runs, even on the main and
other protected Git branches. See cache saving
eligibility.
boolean
Run without using any existing caches. Step caches are still saved at the end
of the run. Useful for refreshing caches after a config change.
Visual diff
boolean
Update locally stored golden files for
visualDiff steps. Without this
flag a visualDiff step fails when the screenshot differs from its golden;
missing goldens are always created on first run regardless of this flag.Sharding
string
1-indexed shard to run. Defaults to
1. Must be less than or equal to
--shard-count.string
Total number of shards. Defaults to
1 (no sharding).Output
string
Directory to store run artifacts (screenshots, logs, results). Defaults to the
project’s
outputDir or ./test-results. The directory is cleared at the
start of a run.boolean
Upload test results to the Momentic dashboard after the run. Equivalent to
running
momentic-mobile results upload <outputDir> once the run finishes.string
Output reporter. Pass multiple times to combine reporters
(e.g.
--reporter=list --reporter=junit).Live reporters render progress to the terminal as the run unfolds:list: per-test rows. Default. On a TTY the running rows redraw in place with their current step; on non-TTY each test commits a single row when it finishes.steps: append-only lines logging each step as it starts and finishes, with per-step durations, sections (setup/main/teardown), and nesting via indentation (modules, AI actions, loops). Suited to CI logs, which don’t render thelistreporter’s in-place redraws.
--reporter-dir. The following are
supported for mobile runs:jsonjunitallureallure-jsonbuildkite-json
string
Directory where reporter output is saved. Defaults to
./reports. Filenames
derive from --name (or the project name).string
Logging verbosity. One of
error, warn, info, or debug.Local devices
string
Force tests to use a specific local Android Virtual Device (AVD). Overrides
all configuration at the test and environment level.
string
Override the APK installed on emulator initialization. Requires
--local-avd-id.string
Force tests to use a specific local iOS simulator device type. Accepts any
option Xcode supports when creating a new simulator (e.g.,
"iPhone 17").string
Override the iOS app installed on simulator initialization. Requires
--local-ios-device-type.CI
string
Maximum total run time, in minutes. When reached, running tests stop and the
current results are printed.