launch_on_headless_desktop
Launch a GUI application on a hidden off-screen desktop, isolating it from the visible desktop. Enables automated interaction with the app's windows via background input and screenshots.
Instructions
Launch a GUI application on an off-screen desktop (creates it if needed).
The process runs with a full GUI on the hidden desktop. Use list_headless_windows to find its windows, then drive them with background input and capture them with screenshot(hwnd=...). The visible desktop is never touched.
Args: params (LaunchHeadlessInput): desktop name and command line.
Returns: str: JSON {"ok": true, "desktop": "...", "pid": N, "command": "..."}.
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": {
"params": "<params>"
},
"name": "launch_on_headless_desktop"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| params | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |