Read a Codex thread transcript
codex_read_threadRead any Codex thread's message history from local session files, no API call or quota needed, works even when rate-limited. Retrieve recent messages regardless of how the thread was created.
Instructions
Read the message history of any Codex thread — whether it was created interactively (GUI / VS Code / TUI) or programmatically. Reads the thread's rollout JSONL from ~/.codex/sessions directly, so it needs no API call, consumes no quota, and works even when the account is rate-limited. Returns the most recent messages by default.
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>"
},
"name": "codex_read_thread"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Max messages to return, counting back from the most recent. | |
| max_chars | No | Truncate each individual message to this many characters. | |
| thread_id | Yes | The thread/session id (UUID) whose transcript to read. | |
| include_reasoning | No | Include the agent's internal reasoning entries, not just user/agent messages. |