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

> Create and clean up the simulators Mobster manages.

Manage the headless simulators that `mobster verify` and `mobster mcp` run on: list them, prepare one (create, boot, build and start WebDriverAgent), shut them down, erase or delete them. It deletes only simulators Mobster created.

## Usage

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

## Commands

| Command | What it does |
| - | - |
| [`mobster sim list`](#mobster-sim-list) | list Mobster's simulators |
| [`mobster sim release`](#mobster-sim-release) | ask the agents you started to let go of their simulators |
| [`mobster sim prepare`](#mobster-sim-prepare) | create, boot and start WebDriverAgent, timing each phase |
| [`mobster sim biometric`](#mobster-sim-biometric) | test biometric enrollment and authentication on a simulator |
| [`mobster sim shutdown`](#mobster-sim-shutdown) | stop WebDriverAgent and shut down Mobster's simulators |
| [`mobster sim erase`](#mobster-sim-erase) | erase one Mobster simulator |
| [`mobster sim delete`](#mobster-sim-delete) | delete Mobster's simulators |
| [`mobster sim prune`](#mobster-sim-prune) | remove unused simulators and stale WebDriverAgent builds |
| [`mobster sim doctor`](#mobster-sim-doctor) | check what `mobster verify` needs |

## `mobster sim list`

List the simulators Mobster created, with their state and WebDriverAgent address.

### Options

| Name | Default | Description |
| - | - | - |
| `--json` | off | print JSON instead of a table |

## `mobster sim release`

Ask each `mobster mcp` server started by the same app as this shell, such as the agent that runs this command, to release the simulator it holds. It lets go at its next sweep, within 15 seconds. A simulator another app's agent holds is left alone.

### Options

| Name | Default | Description |
| - | - | - |
| `--all-mine` | required | every simulator held by an agent started from the same app as this shell |

## `mobster sim prepare`

Create the simulator if needed, boot it headless, build WebDriverAgent the first time, start it on 127.0.0.1, and print how long each phase took. It stays up afterwards.

### Options

| Name | Default | Description |
| - | - | - |
| `--device NAME` | iPhone 17 Pro, else the newest iPhone the runtime supports | the simulator device type |
| `--runtime NAME` | the newest installed | the iOS runtime, such as "iOS 26.4" |
| `--json` | off | print the simulator and the phase times as JSON |

## `mobster sim biometric`

Read or change biometric enrollment, or send a Face ID or Touch ID test event to an idle, booted Mobster simulator. Real devices are never supported. A sent event does not confirm that the app authenticated.

### Arguments and options

| Name | Default | Description |
| - | - | - |
| `UDID` | required | the booted Mobster simulator |
| `{status,enroll,unenroll,match,nonmatch}` | required | read enrollment, enable or disable it, or send a match or nonmatch event |
| `--type {face-id,touch-id}` | face-id; enrollment is shared | the biometric event type |
| `--json` | off | print enrollment and event delivery as JSON |

## `mobster sim shutdown`

Stop WebDriverAgent and shut down every Mobster simulator that isn't running a check, or the one named.

### Arguments

| Name | Default | Description |
| - | - | - |
| `[UDID]` | none | only this simulator |

## `mobster sim erase`

Shut down and erase one Mobster simulator: its apps and data go, and the next run boots it fresh.

### Arguments

| Name | Default | Description |
| - | - | - |
| `UDID` | required | the simulator to erase |

## `mobster sim delete`

Shut down and delete Mobster's simulators. Only UDIDs in Mobster's registry whose names start with “Mobster · ” are deleted; any other UDID is refused.

### Arguments and options

| Name | Default | Description |
| - | - | - |
| `[UDID]` | none | the simulator to delete |
| `--all` | off | delete every Mobster simulator |

`UDID` and `--all` can't be used together; one is required.

## `mobster sim prune`

Delete Mobster simulators unused for 14 days, WebDriverAgent builds for Xcode versions no longer installed, and registry entries for simulators that are gone.

### Options

| Name | Default | Description |
| - | - | - |
| `--json` | off | print what was removed as JSON |

## `mobster sim doctor`

Check Xcode, the iOS runtime, the device type, git, disk space, WebDriverAgent, Mobster's simulators, ports, and your OpenAI or Anthropic key for Smart, and print the fix for each problem. It never runs sudo and never downloads a runtime.

### Options

| Name | Default | Description |
| - | - | - |
| `--fix` | off | prepare the simulator: create, boot and build WebDriverAgent once |
| `--json` | off | print \{"ok", "checks": \[\{"key", "label", "state", "detail", "fix"}]} |


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