Free tool · no signup, nothing to install

Codex Usage Checker

See what is left of your Codex limits and when each one resets. Pick your sessions folder, and the newest reading is found right here in your browser.

ContextBolt · Codex usage checker reads in your browser
Your sessions stay on your computer

Pick the sessions folder inside .codex

Codex saves your limits in its session files after each reply. This page finds the newest reading, here in your tab.

or drop it on this window

Your browser may ask to “upload” the folder. That is its word for letting this page read it. Nothing is sent.

On a phone? The folder is on the computer you run Codex on, so open this page there.

Can’t see it?
  1. In the folder picker, press Cmd+Shift+G, type ~/.codex/sessions and press Return.
  2. Choose the sessions folder itself. Cmd+Shift+. shows the hidden .codex folder.
  1. In the folder picker, type %USERPROFILE%\.codex\sessions in the Folder box and press Enter.
  2. Choose the sessions folder itself. Not there? Turn on Hidden items in File Explorer's View menu.
  1. In the folder picker, press Ctrl+L, type ~/.codex/sessions and press Enter.
  2. Or open your home folder and press Ctrl+H to show the hidden .codex folder.
~/.codex/sessions/…/rollout-….jsonl
The checker opens your newest session files and uses the limits line Codex writes after each reply. Your prompts and code are ignored and nothing is uploaded.

Only use Codex in ChatGPT on the web? Your limits are at chatgpt.com/codex/settings/usage.

Where Codex keeps its sessions

In .codex/sessions, in your home folder, with a folder for each day inside it. Pick the sessions folder itself and the checker finds the newest reading.

  • macOS

    ~/.codex/sessions
    1. In the folder picker, press Cmd+Shift+G, type ~/.codex/sessions and press Return.
    2. Choose the sessions folder itself. Cmd+Shift+. shows the hidden .codex folder.

  • Windows

    C:\Users\you\.codex\sessions
    1. In the folder picker, type %USERPROFILE%\.codex\sessions in the Folder box and press Enter.
    2. Choose the sessions folder itself. Not there? Turn on Hidden items in File Explorer's View menu.

  • Linux

    ~/.codex/sessions
    1. In the folder picker, press Ctrl+L, type ~/.codex/sessions and press Enter.
    2. Or open your home folder and press Ctrl+H to show the hidden .codex folder.

Codex in WSL? The folder is in your Linux home, at \\wsl.localhost\Ubuntu\home\you\.codex\sessions with your distribution’s name. Set CODEX_HOME? Then the sessions folder is inside it.

How Codex usage limits work

Codex counts against your ChatGPT plan’s allowance in windows. The checker draws a ring for each window Codex reports, labeled by its length.

5 hours Current session

On Plus, Codex has a five-hour window. OpenAI says Pro plans currently have no five-hour limit, so on Pro this ring is not there.

7 days This week

The weekly limit is the one that ends a week early. The checker shows the day and time it resets, so you can see how long a low ring has to last.

  • One allowance: OpenAI says Codex shares it with ChatGPT Work, ChatGPT for Excel and Workspace Agents where your plan has them. Ordinary ChatGPT chat is not on that list.
  • Local and cloud together: OpenAI says both use the same allowance, and the reading here catches up the next time Codex runs on your computer. A model with limits of its own shows as small rings.

Keep these rings live on Context Board

This page reads your folder once. Context Board keeps the same rings on screen for Codex and Claude Code, beside the sessions that are waiting for you.

AI usageClaude Code · Codexnow
Claude Code
76%leftCurrent sessionresets in 4h 10m
68%leftThis weekresets Mon 9:00 AM
Codex
23%leftCurrent sessionresets in 2h 14m
41%leftThis weekresets Thu 2:00 PM
As they last checked, 1m ago
Codexapi · main1m
Working
Adding retries to the webhook queue
Wrote the migration tests
Needs you1 sessionnow
  • Codex · billingwants an OK to run migrations3m
Today's commitsGitnow
  • Retry failed webhooks with backoffapi12:06
  • Annual plan toggle on pricinglanding10:41
  • Move invoices to the new tablebilling09:15

Codex under 20% of the week? The next big refactor goes to Claude Code.

An example Context Board named Agents. Every number on it is example data.

  • Add it once

    Start from the Agents template, which has AI usage on it, or add AI usage from the gallery.

  • Every computer

    A small program, set up once with one line, links each computer or server. Usage comes from all of them.

  • Your sessions stay yours

    Only names, states and percentages leave your computer, never your prompts, your code or what Codex wrote.

Start free trial Try the live demo

Free for 3 days, then $12 a monthHow the AI usage widget worksSee Context Board

Frequently asked questions

Something else on your mind? Get in touch.

How do I check my Codex usage?

In the Codex CLI, type /status during a session to see your remaining limits. On the web, open chatgpt.com/codex/settings/usage for your limits, reset times and credit balance. This checker shows the same limits from the readings Codex saves in your sessions folder, with nothing to install.

My browser asked to upload the folder. Is anything sent?

No. “Upload” is the browser's word for letting a page read a folder you chose. The checker opens your newest session files in your tab, uses the limits line Codex writes after each reply, and ignores the rest, your prompts and code included. Nothing is uploaded or stored, and like every page on this site this one loads fonts and analytics that carry nothing from your files. Once the page has loaded, the checker works with your internet off. Rather not pick the whole folder? Pick one session file instead, the newest one in today's folder.

Where is the Codex sessions folder?

At ~/.codex/sessions on macOS and Linux, and C:\Users\you\.codex\sessions on Windows. Codex keeps a folder for each day inside it, and each session is a rollout file. The dot in .codex hides it. In a Mac folder picker, Cmd+Shift+. shows hidden folders, and on Linux, Ctrl+H does. If you set CODEX_HOME, the sessions folder is inside that instead.

Why is there only one ring?

The checker draws the windows Codex reports for your plan, and labels each by its length. On Plus that is a five-hour window and a week. OpenAI says Pro plans currently have no five-hour limit, so on Pro the week is the ring to watch.

Why is my reading hours old?

Codex saves a reading after each reply, so the newest one is from the last time you used it on this computer. A window that has reset since then shows as renewed. Send Codex one message, then pick the folder again for a fresh reading.

Does platform.openai.com/usage show the same thing?

No. That is the API usage dashboard, for spend on API keys. When you sign in to Codex with ChatGPT, your work draws on your plan instead, and that is what this checker and chatgpt.com/codex/settings/usage show. How to check Codex usage has every place to look.

Go deeper

Keep reading

Every free tool

Keep your limits in sight

Context Board is free for 3 days, then $12 a month. One plan with every connection, widget and theme.

Start free trial Try the live demo first