desktop_cursor_overlay_enable
Enable and configure a cursor overlay for the selected desktop session so agent clicks, pointer movement, and intent labels are visibly rendered.
Instructions
agent-desktop cursor-overlay enable: Enable and configure the cursor overlay for the selected session
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_cursor_overlay_enable"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| bow | No | Path curvature multiplier from 0 (straight) to 3 (default 1) | |
| rim | No | Cursor outline colour as a hex value (default #111318) | |
| fill | No | Cursor body colour as a hex value (default: the accent colour) | |
| size | No | Cursor size multiplier from 0.5 to 4.0 (default 1.0) | |
| image | No | Draw the cursor from a PNG file instead of the built-in arrow; scaled by --size | |
| label | No | Show caller-authored intent text beside the cursor overlay | |
| accent | No | Cursor, ripple and element highlight colour as a hex value (default #4299FF) | |
| tremor | No | Hand tremor amplitude in points, 0 to 4 (default 1.1) | |
| hotspot | No | Point in the image, in image points from its top-left, that marks the click position (default 0,0) | |
| dwell_ms | No | Pause on the target before the action runs, 0 to 300 (default 0) | |
| max_words | No | Limit the cursor overlay label to 1-12 words (default 6) | |
| no_ripple | No | Do not play the ripple when the agent clicks | |
| overshoot | No | Overshoot past the target as a fraction, 0 to 0.15 (default 0.035) | |
| travel_ms | No | Cursor travel time range in ms, short to long moves (default 90,320) | |
| motion_seed | No | Vary each move deterministically from this seed | |
| multi_agent | No | Require agent IDs for desktop UI actions; use without --agent-id to configure the session | |
| no_highlight | No | Do not outline the element when the agent clicks | |
| pointer_image | No | PNG shown instead while the cursor rests on a button, link or other pressable control | |
| pointer_hotspot | No | Click point in the pointer image, in image points from its top-left (default 0,0) |