Launch an app, folder or document
launchOpen an app, folder, document, or Settings page and hand the foreground back to the user, returning each new window with proof of which request created it.
Instructions
Open an application (name, absolute path or Store app id, with its arguments), a folder or a document (absolute path) or a Settings page (ms-settings:...) and give the foreground back to the user. Returns the windows attributed to this launch, each with its proof: "process" (the process the shell returned), "folder" (a new Explorer window showing exactly that folder) or "application" (the requested application, started after the request: another instance started at the same moment could be taken for it; a Store app by its app id); other new windows come back as candidates (outcome unknown). Look at one before acting.
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": "launch"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| app | Yes | Application, folder, document or Settings page; a program may be followed by its arguments as a Windows command line ("C:\My Apps\app.exe" "C:\x\note.txt") | |
| args | No | Arguments of a program (.exe or application name), as a Windows command line, quoted like on the command line; never a switch for a Chromium/Electron application |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| next | No | ||
| bound | No | ||
| title | No | ||
| hidden | No | ||
| reason | No | ||
| status | Yes | Outcome: opened, verified, unknown, prompted, unmet, sent-unconfirmed… | |
| window | No | ||
| windows | No | Windows attributed to this launch, with their proof | |
| bindable | No | ||
| candidates | No | Other new windows (outcome unknown) | |
| nativeWindow | No | ||
| foregroundReturned | No |