host_exec_start
Launch local executables in the background as detached processes, specifying arguments, working directory, priority, and timeout to supervise long-running host tasks.
Instructions
Spawn a software process running locally on the host machine in the background.
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": {
"command": "<command>"
},
"name": "host_exec_start"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cwd | No | Working directory. Defaults to current workspace. | |
| tag | No | Optional human-readable label or purpose for this process. | |
| args | No | Command-line arguments. | |
| command | Yes | The executable or command to run (e.g. "npm", "python", "docker", "cargo"). | |
| priority | No | Task scheduling priority (low, normal, high, critical). | |
| timeoutMs | No | Execution timeout in milliseconds. If exceeded, automatically terminates. | |
| allowShell | No | Whether to execute within a shell (cmd.exe or /bin/sh). Defaults to false for injection safety. | |
| spillToFile | No | Spill output to temporary disk file to protect memory on large builds. | |
| logBufferSize | No | Max stdout/stderr lines to buffer in memory (default: 2000). |