Replay a recorded session or Maestro flow
replayRun a recorded automation script, including Maestro YAML flows, to replay actions on a device. Keeps the session active for follow-up automation when the script has no terminal close.
Instructions
Run a recorded automation script, including compatible Maestro YAML flows. A script without a terminal close leaves its session active for subsequent automation. Times out after 90s; a caller-supplied budget extends it.
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": {
"path": "<path>"
},
"name": "replay"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| env | No | ||
| path | Yes | ||
| udid | No | Apple device or simulator UDID. | |
| force | No | ||
| device | No | Device name; ids go in udid or serial. | |
| serial | No | Android, HarmonyOS, or Vega VVD serial. | |
| update | No | ||
| backend | No | ||
| maestro | No | ||
| session | No | Session name. | |
| testIme | No | Activate the headless Android test IME for the sessions this replay opens (default on for emulators; opt-in on real devices). | |
| platform | No | Device platform. | |
| bundleUrl | No | Bundle URL hint inherited by replay-opened sessions. | |
| metroHost | No | Metro/debug host hint inherited by replay-opened sessions. | |
| metroPort | No | Metro/debug port hint inherited by replay-opened sessions. | |
| timeoutMs | No | Operation wall-clock budget in milliseconds (default 60000). The client allows another 30000 milliseconds for the daemon result. | |
| resumeFrom | No | ||
| saveScript | No | ||
| keepSession | No | Leave the session active by suppressing exactly an authored terminal close in native .ad. | |
| deviceTarget | No | Device form factor. | |
| resumePlanDigest | No |