Agent-readable docs index: /llms.txt. Full docs in one file: /llms-full.txt. Download /docs.zip to grep all markdown files locally.

hold-drag

hold-dragTOOL
Long press at (x1,y1), then drag to (x2,y2) with the button still held: moves items that need a long press first, like Home Screen icons
The button goes down at (x1,y1), stays still for --hold, moves to (x2,y2) over --duration, then goes up. A plain swipe starts moving at once, so items that need a long press first do not move with it.
  • Home Screen icons, from the normal Home Screen: --hold 2500 (iOS enters edit mode while held, then the icon follows). Works with AssistiveTouch > Perform Touch Gestures on (SE2, iOS 18.6). Leave edit mode with key home.
  • Start on the icon, not on the AssistiveTouch button next to it.
  • Slow drags (default 1000 ms) let iOS follow the item.
CLI flags in this text are arguments: --hold = holdMs, --duration = durationMs, --screenshot = screenshot, --screentext = screentext, --language = language, --scale = scale, --wait-text = waitText, --timeout-ms = timeoutMs
Examples (arguments): {"lease":"studio:42","screenshot":true,"x1":60,"x2":300,"y1":120,"y2":400}
Parameters
durationMs?number
Drag duration after the hold (default: 1000)
holdMs?number
How long to stay still before the drag, 100-10000 (default: 1000)
language?string
OCR language, e.g. it-IT; en-US is always included
lease *string
Lease id exactly as acquire printed it, e.g. "studio:42"
mac?string
Mac slug from list, e.g. "studio". Needed when several Macs are online
scale?number
Image and coordinate size as a fraction of native pixels (default: screen points; 1 = native)
screenshot?boolean
Return the screen image after the input, once the screen is still
screentext?boolean
Return the OCR text of the screen after the input (x,y wxh text lines)
timeoutMs?number
With waitText: deadline in ms, 1...60000 (default: 5000)
waitText?string
After the input, poll OCR until a line contains this (case-insensitive); never repeat input
x1 *number
Long press x
x2 *number
Drop x
y1 *number
Long press y
y2 *number
Drop y
Request example
{
  "method": "tools/call",
  "params": {
    "name": "hold-drag",
    "arguments": {
      "durationMs": 0,
      "holdMs": 0,
      "language": "string",
      "lease": "string",
      "mac": "string",
      "scale": 0,
      "screenshot": true,
      "screentext": true,
      "timeoutMs": 0,
      "waitText": "string",
      "x1": 0,
      "x2": 0,
      "y1": 0,
      "y2": 0
    }
  }
}