Free tool by WhichBuildWon

Codex Usage Dashboard

See your live Codex 5-hour and weekly usage, remaining allowance, and exact reset times without opening ChatGPT settings.

Free · Local · Open source · No WhichBuildWon account required

View source on GitHub

Install

Clone the repository and run the installer. It copies codex-usage to ~/.local/bin without sudo; if that directory isn’t on your PATH, the installer prints the exact line to add.

git clone https://github.com/fiz-is/codex-usage-dashboard.git
cd codex-usage-dashboard
./install.sh

Check your usage

Run it in your terminal:

codex-usage

Example output below — not your live account data.

Codex Usage

5-hour limit
88% remaining
Resets Aug 30 at 9:24 AM PDT (in 4h 46m)

1-week limit
75% remaining
Resets Sep 5 at 4:48 PM PDT (in 6d 12h)

Prefer a browser view? codex-usage --web opens a local dashboard on 127.0.0.1, refreshes every 60 seconds, and includes a manual Refresh button. Press Ctrl+C in the terminal to stop it.

codex-usage --web

How it works

codex-usage runs entirely on your machine using the Codex CLI you already have installed. It asks the CLI’s local app-server for your authenticated rate-limit state over the account/rateLimits/read method, the same information Codex itself uses.

You do not provide an OpenAI API key. Your Codex credentials and usage data never leave your machine, and WhichBuildWon never sees or receives them.

The Codex app-server interface it depends on is experimental and internal to Codex, so a future Codex release could change how it behaves.

Requirements

macOS
Python 3
The Codex CLI installed and available as codex
An authenticated Codex account (codex login)

FAQ

How do I check my Codex usage?

Install codex-usage, then run codex-usage in your terminal. It prints your current 5-hour and weekly usage windows with exact local reset times.

When does my Codex usage reset?

codex-usage shows the exact reset time for both the 5-hour and weekly window, converted to your local timezone, plus a countdown.

Does it show the weekly Codex limit?

Yes. It reports both the 5-hour limit and the 1-week limit in the same output.

Does WhichBuildWon receive my Codex credentials or usage data?

No. codex-usage runs locally and talks only to your installed Codex CLI. WhichBuildWon does not host the tool, receive your data, or see your usage.

Is the Codex Usage Dashboard free?

Yes. It is a free, open-source utility. Get it on GitHub.

Does it work without logging into Codex?

No. It reads your authenticated Codex session, so you need to have already run codex login.