desktop_launch
Launch a desktop application and return once its process is running. Optionally wait for a window, expose a DevTools endpoint, or start a fresh instance.
Instructions
agent-desktop launch: Launch application and return once its process is running; --activate waits for a window, --cdp verifies a DevTools endpoint
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": {
"app": "<app>"
},
"name": "desktop_launch"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| app | Yes | Application name or bundle ID | |
| cdp | No | Expose the app's DevTools protocol endpoint on this port (0 or omitted picks a free port) | |
| cwd | No | Working directory for the launched process | |
| env | No | Environment variable for the launched process | |
| args | No | Command-line argument passed to the launched app; repeatable, order preserved. For values starting with '-', use --arg=<value> | |
| timeout | No | Upper bound in ms for the whole launch | |
| activate | No | Bring the app forward so it presents a window, and wait for one | |
| no_attach | No | Start a fresh instance instead of attaching to a running one (Windows fails if the app is already running) |