Steer a running Codex turn
codex_steerAdd instructions to the turn Codex is currently working on without stopping it. Steer an active run mid-task and optionally wait for a progress snapshot.
Instructions
Add instructions to the turn Codex is currently working on, without stopping it.
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": {
"thread_id": "<thread_id>",
"prompt": "<prompt>"
},
"name": "codex_steer"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| prompt | Yes | ||
| thread_id | Yes | ||
| wait_seconds | No | Seconds to block before returning a progress snapshot (default 120). Returns early when the turn finishes or Codex needs an answer. The turn keeps running after this returns. |