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

# mobster links

> List your app’s deep links and check that each lands on its screen.

List the deep links your project has, from .mobster/links.yaml, the Expo config, the Xcode project and links a check opened, and open each on a simulator to see which screen it lands on. A step can then say "open cart" instead of the address.

## Usage

```text theme={"theme":"css-variables"}
mobster links <command>
```

```text theme={"theme":"css-variables"}
examples:
  mobster links list
  mobster links check
  mobster links check cart --sim "iPhone 17 Pro"
```

## Commands

| Command | What it does |
| - | - |
| [`mobster links list`](#mobster-links-list) | list the project's deep links and where each came from |
| [`mobster links check`](#mobster-links-check) | open each link on a simulator and record the screen it lands on |

## `mobster links list`

List the project's deep links: the ones in .mobster/links.yaml, the Expo config's scheme and associated domains, the Xcode project's URL types and associated domains, and links a check opened successfully. Dynamic Expo config runs `npx expo config`.

### Options

| Name | Default | Description |
| - | - | - |
| `--json` | off | print them as JSON |
| `--project DIR` | the one you are in | the project folder |

## `mobster links check`

Open each link on a simulator, in the app, and say what screen it landed on: passed when the screen shows the link's title, failed with a screenshot when it doesn't. Name links to check some; with none, every link is checked.

### Arguments and options

| Name | Default | Description |
| - | - | - |
| `[NAME ...]` | all | links to check, by name or address |
| `--sim TYPE` | none | a simulator, such as "iPhone 17 Pro"; repeatable |
| `--device NAME` | none | an iPhone from `mobster devices`; repeatable |
| `--bundle ID` | read from the project | the app's bundle ID |
| `--app PATH` | the app already on the simulator | a built .app to install |
| `--json` | off | print results.json's document |
| `--project DIR` | the one you are in | the project folder |

```text theme={"theme":"css-variables"}
exit codes: 0 every link landed where it should, 1 one didn't, 3 couldn't

examples:
  mobster links check
  mobster links check cart profile --sim "iPhone 17 Pro"
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.