Skip to main content
Prints one test file path per line for every test in the current project that matches the provided filters. Pipe it into other commands. Requires tests to exist locally as YAML files.

​
Arguments

​
array
Tests to list, 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. When omitted, Momentic searches the current directory and its parents for momentic.config.yaml or a workspace configuration. Use this flag to select a project when discovery finds more than one.
​
string
When using workspaces, load the project whose name matches the filter.

​
Filtering

​
array
Only list 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.
​
boolean
Only list tests changed against the base branch: changed test files plus tests that use a changed module (it lists those affected tests, not the module files). The base branch is auto-detected from the CI pull request, or origin/HEAD. Requires the checkout to have full Git history. Pipe into run to re-run only what a Permanent healing PR touched.

​
Examples

List every test in the project:
List tests under a specific folder:
List tests with the smoke label, then run the same selection:
Validate a Permanent healing PR by running only the tests it changed. This Bash example preserves spaces in paths and skips run when the list is empty; calling run without paths would run the whole project: