desktop_session_start
Create a session directory and manifest to begin a desktop automation session, optionally enabling tracing, cursor overlay, screenshots, or per-subagent cursors.
Instructions
agent-desktop session start: Create a session directory and manifest
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_session_start"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | Optional human-readable session label | |
| cursor | No | Show the visual cursor overlay with its default style | |
| no_trace | No | Create the session without automatic tracing | |
| multi_agent | No | Give each harness subagent its own cursor; requires --agent-id on desktop actions | |
| screenshots | No | Capture pre/post-action screenshots and refmap copies (requires tracing; sensitive) |