WhichBuildWon

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 · No WhichBuildWon account required

Updated

Install

Install it with one command. It downloads codex-usage directly from WhichBuildWon and installs it to ~/.local/bin without sudo. If that directory isn’t on your PATH, the installer prints the exact line to add.

curl -fsSL https://www.whichbuildwon.com/downloads/codex-usage/install.sh | 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 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. The program file is hosted by WhichBuildWon, but it runs locally after installation. Your Codex credentials and usage data are not sent to WhichBuildWon; Codex itself continues to communicate with OpenAI as it normally does.

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. The program file is hosted by WhichBuildWon, but codex-usage runs locally and talks to your installed Codex CLI. Your Codex credentials and usage data are not sent to WhichBuildWon.

Is the Codex Usage Dashboard free?

Yes. It is free to install and use.

Does it work without logging into Codex?

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