open
Open an app, deep link, URL, or platform surface. Specify platform, device, and optional arguments to launch on iOS, Android, desktop, or TV.
Instructions
Open an app, deep link, URL, or platform surface.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| session | No | Agent-device session name. | |
| platform | No | Platform selector used to resolve a device. | |
| deviceTarget | No | Device target form. Maps to the CLI --target flag. | |
| target | No | Alias for deviceTarget on commands without a UI target field. Interaction commands reserve target for the UI element. | |
| device | No | Device name selector. | |
| udid | No | iOS device UDID selector. | |
| serial | No | Android serial selector. | |
| iosSimulatorDeviceSet | No | iOS simulator device-set path used for device resolution. | |
| androidDeviceAllowlist | No | Android serial allowlist used for device resolution. | |
| daemonBaseUrl | No | Remote daemon base URL. | |
| daemonAuthToken | No | Remote daemon auth token. | |
| tenant | No | Remote tenant identifier. | |
| runId | No | Lease run identifier. | |
| leaseId | No | Existing lease identifier. | |
| cwd | No | Working directory for command execution. | |
| debug | No | Enable debug diagnostics. | |
| app | No | App name, bundle id, package, or URL. | |
| url | No | Optional URL passed with an app shell. | |
| surface | No | ||
| activity | No | Android activity name. | |
| launchConsole | No | Launch console mode. | |
| launchArgs | No | Launch arguments forwarded verbatim to the platform launch command. | |
| relaunch | No | Force relaunch. | |
| saveScript | No | ||
| noRecord | No | Do not record this action. | |
| stateDir | No | Agent-device state directory. |