desktop_hover
Move the cursor to a target UI element or exact screen coordinates in a headed desktop session to trigger hover interactions and verify hover-dependent behavior.
Instructions
agent-desktop hover: Move cursor to element center or coordinates (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_hover"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| xy | No | Absolute coordinates as x,y; requires --headed; write a negative value with = (--xy=-100,50) | |
| ref_id | No | Element ref to hover over; requires --headed | |
| duration | No | Reserved for compatibility; positive values are rejected in stateless mode (run hover, then `wait <ms>` instead) | |
| timeout_ms | No | Maximum ref-resolution and transient-actionability wait in milliseconds; terminal failures return immediately |