perf
Inspect session performance metrics, frame health, memory diagnostics, CPU profiles, and traces. Sample, snapshot, start, stop, or report performance data for iOS, Android, TV, and desktop apps.
Instructions
Show session performance, frame health, and memory diagnostics.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cwd | No | Working directory for command execution. | |
| out | No | Output artifact path. | |
| area | No | ||
| kind | No | ||
| udid | No | iOS device UDID selector. | |
| debug | No | Enable debug diagnostics. | |
| runId | No | Lease run identifier. | |
| action | No | ||
| 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. | |
| subject | No | ||
| platform | No | Platform selector used to resolve a device. | |
| stateDir | No | Agent-device state directory. | |
| template | No | xctrace template name, for example Time Profiler. | |
| tracePath | No | Existing .trace path to report, defaults to the latest session trace. | |
| 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. |