git:20260810.c2c8154 to git:20260811.b0d4b40

8 added, 20 removed. Audit A to A.

---

name: ios-simulator

description: Verify and debug native, React Native, Expo, or Flutter apps on an iOS Simulator with agent-device. Use when an agent needs to launch an app, inspect its live UI, tap, type, scroll, validate a code change, collect failure evidence, or reproduce a workflow on an iPhone or iPad Simulator.

---

# iOS Simulator

- Use `agent-device` on an iOS Simulator to verify a running app. Work from the live UI, act on current refs or selectors, and verify the result before closing the session.

- For an app or bundle id, open it in the foreground:

+ Require the `agent-device` CLI to be installed separately before driving a simulator:

```bash

- agent-device open <app-or-bundle-id> --platform ios --foreground

+ npm install -g agent-device@latest

```

- `open` returns the initial interactive snapshot. Use its current refs or a selector. For a planned action, use `--settle`. If the settled diff shows the next target, continue from it:

- ```bash

- agent-device press @eN --settle

- agent-device fill @eN "text" --settle

- ```

+ Treat installation and upgrades as user-owned setup steps. Do not run that command autonomously or substitute a mutable `npx -y agent-device@latest` invocation.

- Run `agent-device snapshot -i` only when the settled diff does not show the next target. `type` never takes `--settle`; verify it with a snapshot or named `wait`. Keep state-changing commands serial. Verify the end state with a selector or exact text, then close:

+ For a normal app-driving task, start immediately. Do not probe first with `--help`, `--version`, `devices`, `appstate`, `snapshot`, or `screenshot`. Target iOS explicitly when opening an app or bundle id:

```bash

- agent-device close

+ agent-device open <app-or-bundle-id> --platform ios --foreground

```

- For non-routine work, use the version-matched CLI help:

- ```bash

- agent-device help validate

- ```

+ Follow the initial interactive snapshot and corrective error hints. If the shell reports that `agent-device` is unavailable, stop and ask the user to install it or expose their existing installation on `PATH`.

- Read only the relevant follow-up topic for specialized work:

+ Only when the task is specialized or a command shape is unclear, read the relevant version-matched help topic:

```bash

+ agent-device help validate # engineering validation and build freshness

agent-device help debugging # screenshots, logs, traces, video, and failures

agent-device help react-native # React Native and Expo runtime guidance

agent-device help react-devtools # component tree, props/state/hooks, and renders

agent-device help scripting # durable replay and CI workflows

```

- If platform help says a capability is unavailable, follow it. Keep diagnostic output when verification fails.