matrix_run
Build and run a Connect IQ app on multiple devices, capture screens, optionally execute button/touch scenarios, and compare each step with .ciq baselines, creating or updating them when needed.
Instructions
Build, run and capture one screen per device, optionally run a button/touch scenario, and compare each step against .ciq/baselines. Creates baselines when missing or when update_baselines is true.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"project_dir": "<project_dir>",
"devices": "<devices>"
},
"name": "matrix_run"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| steps | No | Optional input scenario run after the first capture, with a baseline per step | |
| devices | Yes | Device ids from list_devices | |
| wait_ms | No | Monkeydo startup wait per device (default: 3000) | |
| isolated | No | Launch on a hidden desktop when the simulator is not running (default: true on Windows) | |
| settle_ms | No | Extra settle time before capture (default: 1200) | |
| threshold | No | Per-pixel channel delta for diffs (default: 12) | |
| output_dir | No | Current capture directory (default: <project>/.ciq/current) | |
| jungle_file | No | Explicit jungle file | |
| project_dir | Yes | Monkey C project directory | |
| baseline_dir | No | Baseline directory (default: <project>/.ciq/baselines) | |
| debug_channel | No | Build with the debug automation channel (default: true) | |
| update_baselines | No | Overwrite baselines with this run | |
| reset_before_each | No | Clear app storage and stop the app before each device (default: true) | |
| developer_key_path | No | Explicit developer key |