Skip to main content
Your engineers already run OpenAI Codex every day. Codex session capture brings those coding sessions into AgentEye as ordinary sessions and events, so you can search, replay, and evaluate them next to everything else you observe. It complements the Python SDK: the SDK instruments agents you write, while this captures the Codex work your team already does — with no change to how they run it. A small background collector reads Codex’s local session transcripts as they are written and ships them to AgentEye. One collector per machine captures every local Codex surface at once — there is no per-surface setup. The same collector captures other agents too — see OpenClaw and Hermes. Enable each one you run; a single collector can capture several at once.

​
What it captures

Every Codex surface that runs locally produces the same on-disk session transcripts, and the collector picks up all of them:
  • the Codex CLI and codex exec
  • the VS Code / IDE extension
  • the desktop app, when it runs a session locally
Each Codex session becomes an AgentEye session; its user and assistant messages, reasoning, tool calls, tool results, and token usage become the matching events. The surface each session came from (CLI, IDE, or desktop) is recorded, so you can tell them apart.
Cloud sessions are not captured. The desktop app increasingly runs sessions in the Codex cloud and keeps only their metadata on the machine — there is no local transcript to read. Only locally-executed sessions are captured.

​
Turn it on

Capture is off until you enable it. Install the collector with an API key that has the events:add permission (see API keys), and turn on Codex capture:
That installs the collector, registers it as a background service, and starts capturing. Confirm it is running:
On first run, your existing Codex sessions are backfilled once and new activity then streams within seconds. Codex’s own files are only ever read — never modified, moved, or deleted — and each session is shipped exactly once, even across restarts.

​
Where it shows up

Captured sessions appear in Sessions, and their events in the Events stream, the same as any other agent you observe — so session replay, search, evaluations, and alerts all work on them. Filter by the Codex agent to see them on their own.

​
Privacy

Codex transcripts contain the full session — including command output, file contents, and anything Codex read or wrote — and can contain secrets. Captured sessions are shipped as-is, so enable capture only on machines and for teams where centralizing that content in AgentEye is appropriate, and give the collector a key scoped to events:add only. See Security for how your data is kept isolated.