codex_terminals
List, terminate, or clean background Codex terminals for a task using paginated cursors and process IDs, so you can monitor and stop running processes without shell access.
Instructions
list takes cursor/limit; terminate takes process_id; clean stops all background terminals. Mutations need an operation key. No arbitrary shell or stdin.
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": {
"task_id": "<task_id>"
},
"name": "codex_terminals"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | ||
| action | No | list | |
| cursor | No | Native cursor | |
| task_id | Yes | Task id | |
| process_id | No | ||
| request_id | No | Key for identical retries | |
| operation_id | No | Alias of request_id |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ok | Yes | ||
| result_version | Yes |