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

scroll

scrollTOOL
Scroll with the Bluetooth mouse wheel over a point (default: screen center). Use this to scroll web pages and lists; one tick is about 100 points
down shows content further down (like a finger swipe up); up shows content above. right shows content further right (carousels, wide tables); left goes back.
  • One tick moves about 100 points in Safari, about 115 in Settings-style lists (UITableView), measured on an XR (896 points high, so scroll down 8 is about one screen). These are estimates: check the result with --screentext.
  • Faster than swipe for long distances: swipes have no momentum.
  • --at: the content under this point scrolls (for a list inside a page or sheet).
  • ticks 1-1000. At the end of the content nothing moves; compare --screentext.
  • Date and picker wheels: scroll up 2 --at x,y over the wheel moves about 3.3 rows per tick (XR, iOS 18.7). Scroll near the target, tap the row, read the result.
CLI flags in this text are arguments: --at = x, y, --screenshot = screenshot, --screentext = screentext, --language = language, --scale = scale, --wait-text = waitText, --timeout-ms = timeoutMs
Examples (arguments): {"direction":"down","lease":"studio:42","screentext":true,"ticks":5} {"direction":"up","lease":"studio:42","screenshot":true,"ticks":3,"x":207,"y":500}
Parameters
direction *"up" | "down" | "left" | "right"
down shows content further down, right shows content further right
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)
ticks *integer
Wheel ticks, 1-1000; one is about 100 points
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
x?number
Scroll over this point (default: screen center)
y?number
Scroll over this point (default: screen center)
Request example
{
  "method": "tools/call",
  "params": {
    "name": "scroll",
    "arguments": {
      "direction": "up",
      "language": "string",
      "lease": "string",
      "mac": "string",
      "scale": 0,
      "screenshot": true,
      "screentext": true,
      "ticks": 0,
      "timeoutMs": 0,
      "waitText": "string",
      "x": 0,
      "y": 0
    }
  }
}