Send Codex a message
codex_tellSend messages to a running Codex agent to correct, redirect, or stop it. The message is delivered at its next tool turn; omit job_id to reach all active runs.
Instructions
Send a running Codex agent something it did not ask for — a correction, a change of direction, a stop. It arrives at the next tool turn of that run rather than interrupting it mid-command. Omit job_id to reach every run at once.
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": {
"message": "<message>"
},
"name": "codex_tell"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| job_id | No | Only tell this run. Omit to reach every run, which is what you want for "stop". | |
| message | Yes | What to tell Codex. It reads this at its next tool turn. |