desktop_launch
Launch installed applications by their ID and optionally open existing files or URIs. Returns observed window candidates within a wait period, helping confirm the launch before proceeding.
Instructions
Launch an installed application by its desktop_applications ID, optionally opening absolute existing paths or URIs. Returns dispatched with process-bound window candidates observed for wait_timeout seconds (default 1, range 0–3; 0 skips observation). Candidates do not prove document readiness; singleton association is never guessed. Inspect candidates or desktop_windows before acting; never blindly retry an uncertain launch.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"application_id": "<application_id>"
},
"name": "desktop_launch"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| wait_timeout | No | ||
| files_or_uris | No | ||
| application_id | Yes |