From 782d941de64650c05b066490154e5a3933b788e8 Mon Sep 17 00:00:00 2001 From: PJ Date: Fri, 15 May 2026 14:37:25 +0530 Subject: [PATCH] docs(cli): document --ios-device and per-platform doctor --- docs/manual/cli.md | 15 ++++++++++++++- 1 file changed, 14 insertions(+), 1 deletion(-) diff --git a/docs/manual/cli.md b/docs/manual/cli.md index 9d375f6..131a59d 100644 --- a/docs/manual/cli.md +++ b/docs/manual/cli.md @@ -19,6 +19,7 @@ Run a spec against an app for a fixed duration. | `--launcher-activity` | resolved | Optional `/` to launch. Overrides default resolution. | | `--platform` | `android` | Target platform: `android`, `ios`, or `web`. | | `--avd` | optional (android) | Android AVD name to boot if no device is connected. Required only when no device is connected and multiple AVDs exist. | +| `--ios-device` | optional (ios) | iOS simulator name or UDID to boot if none is running. | | `--duration` | `5m` | Total test duration (`30s`, `5m`, `2h`, `1d`). | | `--seed` | `0` | PRNG seed. `0` uses a random seed and records it in `meta.json`. | | `--output` | `./runs` | Output directory for traces. | @@ -38,7 +39,19 @@ See [the inspect UI page](./inspect/) for the panel reference and keyboard short ## `sanderling doctor` -Check the host environment for a working sanderling setup: Go toolchain, JDK, Maestro availability, emulator reachability, SDK linkage hints. +Check the host environment for a working sanderling setup. + +``` +sanderling doctor [--platform web|android|ios|all] +``` + +`--platform` defaults to `all`, which runs every platform's checks (deduped). Pass a specific platform to scope the output. + +| Platform | Checks | +|---|---| +| `web` | headless Chromium can launch (the bundled CDP surface boots a real browser). | +| `android` | `adb` on PATH; `emulator` on PATH or under `ANDROID_HOME`; Java 17+; embedded Maestro sidecar JAR is real. | +| `ios` | `xcrun` on PATH; `simctl` on PATH; Java 17+; embedded Maestro sidecar JAR is real. | ## `sanderling version`