kill_shell
Terminates a background shell and its entire process group using the returned shell_id, stopping lingering processes from continuing to run.
Instructions
Stop a background shell (kills its whole process group).
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": {
"shell_id": "<shell_id>"
},
"name": "kill_shell"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| fleet | No | Fleet name. Omit to use the default. | |
| context | No | Context name. Omit to use the default. | |
| shell_id | Yes | The shell_id bash returned for a background shell. | |
| workspace | No | Workspace id. Omit to use this session's workspace on the fleet. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| note | No | ||
| ended | No | ||
| state | Yes | ||
| where | Yes | ||
| output | No | ||
| running | No | ||
| started | No | ||
| shell_id | Yes | ||
| warnings | No | ||
| exit_code | No | ||
| workspace | Yes | ||
| description | No | ||
| stderr_bytes | No | ||
| stdout_bytes | No | ||
| omitted_bytes | No |