Codex
Record OpenAI Codex sessions from every laptop.
What it records. Every conversation a person has with the Codex CLI on the laptop: prompts, replies, the model used, tool calls, and token counts.
How. The collector registers with Codex’s system requirements file so Codex calls it after each turn. It reads the turn from Codex’s session file and passes it to the scanner.
Before you begin
- You have the Admin role.
- Codex is installed on at least one enrolled laptop, so you can confirm a session arrives.
Check it is running
It is on when your organization is created, so there is nothing to switch on.
Open Extensions
Under Endpoint Extensions, find Codex. Its switch is on.
Check
The next Codex conversation appears on the Sessions page with Codex as the source, within 15 minutes of the laptop’s next scan.
On the laptop
sudo surface extension list shows codex as installed. sudo surface logs --extension codex shows its activity.
Turn it off
Click the switch. You see “Codex discovery disabled” and laptops remove the hook on their next scan. Click it again to record Codex once more.
Next steps
- Review sessions to open a trace or transcript
- AI usage for cost and top adopters
- Claude Code to record another tool