desktop_find
Searches desktop UI elements by role, name, value, or text and filters by app, window, surface, or state to locate specific controls for inspection and action.
Instructions
agent-desktop find: Search elements by role, name, value, or text content
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_find"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| app | No | Filter to application by name | |
| nth | No | Return Nth match (0-indexed) | |
| last | No | Return last match only | |
| name | No | Match by accessible name or label | |
| role | No | Match by accessibility role (button, textfield, checkbox ...) | |
| root | No | Search only inside this ref's subtree, not the whole window | |
| text | No | Match by text in name, value, title, or description | |
| count | No | Return match count only | |
| exact | No | Require exact (case-insensitive) name/description/value matches | |
| first | No | Return first match only | |
| limit | No | Return at most N matches; defaults to 50 when omitted, use 0 for all | |
| value | No | Match by current value | |
| states | No | Filter by state token (repeatable); append =true or =false | |
| surface | No | Surface to search (menubar, menu, sheet ...) instead of the window | window |
| native_id | No | Match by native automation id (AXIdentifier) | |
| window_id | No | Scope to a single window ID (from list-windows) | |
| timeout_ms | No | Traversal deadline in milliseconds (default 5000; raise for a large tree such as a shell file dialog) | |
| description | No | Match by accessible description |