shell_bg_start
Run a shell command in the background and get a job ID to monitor, log, or stop it later.
Instructions
Start a command in the background and return immediately with a job ID. Use shell_bg_status, shell_bg_log, and shell_bg_stop to manage the job. Default timeout is 30 minutes. Commands run in /bin/sh.
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": "shell_bg_start"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| command | Yes | Shell command to run in the background | |
| timeout | No | Timeout in seconds (default: 1800 / 30 min, max: 86400 / 24h) |