Read messages from Codex
codex_inboxRetrieve messages from a running Codex agent—questions, findings, warnings—via a non-blocking inbox, with cursor pagination to see only new items.
Instructions
Collect anything a running Codex agent has sent — a question it is blocked on, a finding, a warning. Cheap and non-blocking, so it is worth calling between other tools while a run is in flight. Pass the next_cursor from the previous call to see only what is new; awaiting_answer counts the questions still waiting on codex_reply.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "codex_inbox"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| job_id | No | Only messages from this run. Omit to watch every run at once. |