Codex writes every session to a file on your computer: each turn, the token counts of every response, how much of your usage limits you had used, and each command and patch with whether it worked. Usage Insights for Codex turns those files into a dashboard. This lesson gets you from nothing to your first numbers.
Find your history
Codex keeps one file per session, in folders by year, month and day:
| System | Folder |
|---|---|
| macOS and Linux | ~/.codex/sessions |
| Windows | %USERPROFILE%\.codex\sessions |
The .codex folder is hidden. In a file picker, press ⌘ ⇧ . on a Mac or Ctrl H on Linux to show hidden folders. On Windows, type %USERPROFILE%\.codex into the picker's address bar. If you set CODEX_HOME, the folder is there instead.
Codex compresses older sessions to .jsonl.zst. You do not need to unpack them: the dashboard reads both.
Open it in the browser
Open Usage Insights for Codex and either drag the sessions folder onto the page or press Choose the folder and pick it. A bar shows how much has been read. Large folders are read line by line in the background of your tab, so gigabytes are fine.
Nothing is uploaded. The page has no server to send your files to. It keeps counts, names and times, and drops the text of your prompts, Codex's answers and your commands as it reads. If you drop the whole ~/.codex folder by mistake, it still skips auth.json and your config.
Want your threads' names on the dashboard? Press Choose files and add ~/.codex/session_index.jsonl along with the sessions.
Or try the sample first
No sessions on this computer, or want to look around before loading your own? Press Try the sample. It loads a made-up engineering team of 26 people over 120 days, so every view has something in it, the Team view included. The source chip above the dashboard says Sample team (illustrative) so you never mistake it for yours.
Read the first numbers
The row at the top of Me answers the first questions:
- Active days: days with at least one prompt, and the share of working days.
- Conversations / sessions: how many sessions you started, and prompts per session.
- Prompts sent: everything you typed, with a daily average.
- Active time: time between events less than five minutes apart, an estimate, and how long Codex itself worked.
- Streak: days in a row with activity; a quiet weekend does not break it.
- Tokens & reasoning: every token, and how many went into reasoning.
The tabs on the right pick the range, from 7 d to All. Point at any label for how its number is worked out.
Next: read your Codex activity, your rhythm, what Codex built and your habits, in the Me view.