gesture
Execute structured touch gestures such as pan, swipe, pinch, and rotate on real devices to simulate user interactions for testing and debugging.
Instructions
Run a structured gesture.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cwd | No | Working directory for command execution. | |
| kind | Yes | Gesture variant. | |
| udid | No | iOS device UDID selector. | |
| debug | No | Enable debug diagnostics. | |
| delta | No | Movement delta for pan or transform gestures. | |
| runId | No | Lease run identifier. | |
| scale | No | Pinch or transform scale. | |
| device | No | Device name selector. | |
| origin | No | Gesture origin point. | |
| preset | No | Swipe preset. | |
| 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. | |
| degrees | No | Rotation in degrees. | |
| leaseId | No | Existing lease identifier. | |
| session | No | Agent-device session name. | |
| distance | No | Fling distance. | |
| platform | No | Platform selector used to resolve a device. | |
| stateDir | No | Agent-device state directory. | |
| velocity | No | Rotate gesture velocity. | |
| direction | No | Fling direction. | |
| durationMs | No | Gesture duration in milliseconds. | |
| deviceTarget | No | Device target form. Maps to the CLI --target flag. | |
| daemonBaseUrl | No | Remote daemon base URL. | |
| 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. |