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

> List the iPhones and simulators Mobster can use.

List every device Mobster can drive: USB iPhones (set up or newly plugged in), Mobster's simulators, and phone addresses from MOBSTER\_WDA\_DEVICES. Each shows its state: Ready, In use, Connected, Needs setup or Unplugged. Name one with `--device` on run, screen, doctor, serve, mcp and the terminal UI. It changes nothing.

`mobster devices lock-probe` reads whether an iPhone is locked or showing a system sheet (Face ID, a locked app, the App Store's side-button confirmation) the way a task's check does, and lists what the lock screen shows. It taps and types nothing.

`mobster devices status` reads a device's battery and thermal state, and whether this Mac is on battery. A value the device doesn't report is left out. Without `--device` it reads the only device, else the first iPhone set up.

## Usage

```text theme={"theme":"css-variables"}
mobster devices [options] [lock-probe|status]
```

## Arguments and options

| Name | Default | Description |
| - | - | - |
| `[lock-probe\|status]` | none | lock-probe: the lock state and system sheets; status: battery and heat. Neither taps anything |
| `--json` | off | print the devices (or the probe, or the status) as JSON |
| `--wda-url URL` | `$MOBSTER_WDA_URL`, else [http://127.0.0.1:8100](http://127.0.0.1:8100) | lock-probe, status: the phone's address |
| `--device NAME` | none | lock-probe, status: the device to read, by id, UDID or name |

```text theme={"theme":"css-variables"}
examples:
  mobster devices
  mobster devices --json
  mobster devices lock-probe --device "Sam's iPhone"
  mobster devices status --device "Sam's iPhone"
  mobster run "Turn on Dark Mode" --execute --device "Sam's iPhone"
```


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