trace
Start or stop trace capture for debugging apps on iOS, Android, desktop, and TV devices. Specify action, device, and session to control tracing.
Instructions
Start or stop trace capture.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cwd | No | Working directory for command execution. | |
| path | No | ||
| udid | No | iOS device UDID selector. | |
| debug | No | Enable debug diagnostics. | |
| runId | No | Lease run identifier. | |
| action | Yes | ||
| device | No | Device name selector. | |
| serial | No | Android serial selector. | |
| target | No | Alias for deviceTarget on commands without a UI target field. Interaction commands reserve target for the UI element. | |
| tenant | No | Remote tenant identifier. | |
| leaseId | No | Existing lease identifier. | |
| session | No | Agent-device session name. | |
| platform | No | Platform selector used to resolve a device. | |
| stateDir | No | Agent-device state directory. | |
| includeCost | No | Include per-command agent-cost (cost.wallClockMs, …) in structuredContent. Defaults to off; the default response shape is unchanged. | |
| deviceTarget | No | Device target form. Maps to the CLI --target flag. | |
| daemonBaseUrl | No | Remote daemon base URL. | |
| responseLevel | No | Response verbosity: token-cheap digest / default (today) / full. Defaults to default; the default response shape is unchanged. | |
| daemonAuthToken | No | Remote daemon auth token. | |
| iosXctestEnvDir | No | Writable directory for iOS XCTest runner env overlays. | |
| mcpOutputFormat | No | MCP text content format. Defaults to optimized agent-friendly text; use json for JSON text. Structured content is always returned separately. | |
| iosXctestrunFile | No | Externally built iOS XCTest runner .xctestrun artifact path. | |
| iosSimulatorDeviceSet | No | iOS simulator device-set path used for device resolution. | |
| androidDeviceAllowlist | No | Android serial allowlist used for device resolution. | |
| iosXctestDerivedDataPath | No | Derived data path for external iOS XCTest runner execution. |