> ## Documentation Index
> Fetch the complete documentation index at: https://momentic.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# momentic-mobile list

> List local Momentic mobile tests matching a pattern.

Prints one test file path per line for every test in the current project that
matches the provided filters. Intended to be piped into other commands. Requires
tests to exist locally as YAML files.

```bash theme={null}
npx momentic-mobile list
```

## Arguments

<ParamField path="[tests...]" type="array">
  Tests to list, given as test file paths, directories, or test-name substrings.
  Defaults to every test in the current project.
</ParamField>

## Common flags

<ParamField path="-c, --config <config>" type="string">
  Path to the Momentic configuration file. Defaults to `momentic.config.yaml` in
  the current directory.
</ParamField>

<ParamField path="-f, --filter <filter>" type="string">
  When using [workspaces](/configuration/workspace), load the project whose name
  matches the filter.
</ParamField>

## Filtering

<ParamField path="--labels <labels...>" type="array">
  Only include tests with one of the specified labels.
</ParamField>

<ParamField path="--include <includePatterns...>" type="array">
  Only include tests whose file path matches any of the provided regex patterns.
  The pattern only needs to match part of the path.
</ParamField>

<ParamField path="--exclude <excludePatterns...>" type="array">
  Exclude tests whose file path matches any of the provided regex patterns.
</ParamField>

## Examples

List every test in the project:

```bash theme={null}
npx momentic-mobile list
```

List tests under a specific folder:

```bash theme={null}
npx momentic-mobile list tests/login
```

List tests then pipe into `run`:

```bash theme={null}
npx momentic-mobile list tests/login | xargs npx momentic-mobile run
```