> ## 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 results

> Upload, merge, and view local Momentic mobile test results.

Manage the results directory produced by
[`momentic-mobile run`](/cli-reference/momentic-mobile/commands/run). Use
`upload` after running with `--upload-results` disabled, `merge` to combine
sharded runs, and `view` to inspect runs locally without uploading.

```bash theme={null}
npx momentic-mobile results upload
```

## `upload`

Upload local test results to the Momentic dashboard.

```bash theme={null}
npx momentic-mobile results upload [folder]
```

### Arguments

<ParamField path="[folder]" type="string">
  Folder containing results from `momentic-mobile run` or `momentic-mobile
      results merge`. Defaults to `test-results`, which matches the default
  `--output-dir`, so you can usually omit this argument.
</ParamField>

## `merge`

Merge results from multiple sharded mobile runs into a single folder before
uploading.

```bash theme={null}
npx momentic-mobile results merge <parent folder>
```

### Arguments

<ParamField path="<parent folder>" type="string" required>
  Parent folder of the results to merge. For example, if shards wrote into
  `test-results/shard-1` and `test-results/shard-2`, pass `test-results`.
</ParamField>

### Options

<ParamField path="--output-dir <outputDir>" type="string">
  Directory to write the merged results to. The folder is overwritten if it
  exists. Required.
</ParamField>

## `view`

Launch the local run viewer to inspect results without uploading.

```bash theme={null}
npx momentic-mobile results view <results> [runId]
```

### Arguments

<ParamField path="<results>" type="string" required>
  Path to a folder containing a `runs/` subfolder. Defaults to `test-results`.
</ParamField>

<ParamField path="[runId]" type="string">
  Run ID to open, matching a zip file in the `runs/` subfolder. For example, for
  `runs/eed92602-7355-43dc-8d79-1c43029bec26.zip`, pass
  `eed92602-7355-43dc-8d79-1c43029bec26`. When omitted, the viewer opens to the
  run group table.
</ParamField>

### Options

<ParamField path="--port <port>" type="number">
  Port for the local run viewer server. Defaults to `58889`.
</ParamField>

## Examples

Upload the default results folder:

```bash theme={null}
npx momentic-mobile results upload
```

Merge sharded results before uploading:

```bash theme={null}
npx momentic-mobile results merge test-results --output-dir test-results/merged
npx momentic-mobile results upload test-results/merged
```

View a specific run locally on a custom port:

```bash theme={null}
npx momentic-mobile results view --port 59999 my-results eed92602-7355-43dc-8d79-1c43029bec26
```