desktop_drag
Perform drag-and-drop actions between UI elements or screen coordinates. Specify source and destination refs or x,y points, with optional duration and drop-delay controls.
Instructions
agent-desktop drag: Drag from one element or point to another (requires --headed)
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "desktop_drag"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | No | Destination element ref; requires --headed | |
| from | No | Source element ref; requires --headed | |
| to_xy | No | Destination coordinates as x,y; requires --headed; write a negative value with = (--to-xy=-100,50) | |
| from_xy | No | Source coordinates as x,y; requires --headed; write a negative value with = (--from-xy=-100,50) | |
| duration | No | Drag duration in milliseconds | |
| drop_delay | No | Hold over the destination this many ms before releasing, so the drop target activates; default 500 (150 on Linux) | |
| timeout_ms | No | Drag action budget in milliseconds, including resolution, actionability, pickup, duration and drop delay; allow headroom for completion | |
| wait_for_scope | No | Window a drag's --wait-for/--wait-for-gone verification polls: 'to' (drop target, default) or 'from' (pickup). Needed when the confirmation appears only in the destination window of a cross-window drag |