Free & Open Source

Track Your ChatGPT Codex Usage

A minimal macOS menu bar app that tracks your ChatGPT Codex usage limits at a glance. Never hit your rate limit unexpectedly again.

Download for macOS View on GitHub --

or install with Homebrew

brew tap Artzainnn/tap && brew install --cask codexusagebar

Secure macOS 12+ Lightweight

Simple by design

Everything you need, nothing you don't

Menu Bar Native

Lives quietly in your menu bar. One click to see your current usage. Use the Cmd+U shortcut to open from anywhere.

Smart Notifications

Get notified when you're approaching your limit at 25%, 50%, 75%, and 90% usage thresholds.

Live OpenAI status

Know when Codex, the VS Code extension, or ChatGPT is down. Color-coded indicator in the popup with smart alerts for the services you use.

Privacy First

No data collection. No analytics. Your usage data stays on your machine – always.

Open Source

Fully open source and free forever. Inspect the code, contribute, or fork it for yourself.

Lightweight

Under 5MB. Minimal CPU and memory footprint. Built native for Apple Silicon and Intel Macs.

Frequently Asked Questions

Everything you need to know

How does CodexUsageBar get my usage data?

CodexUsageBar reads the sign-in from the official Codex CLI on your Mac and calls OpenAI's own usage endpoint — the same one Codex itself uses. Everything stays local; no third-party server is involved.

Is my data safe?

Yes. Your tokens and usage data never leave your computer. There's no analytics, no telemetry, and no data collection of any kind. CodexUsageBar is fully open source, so you can inspect every line of code.

Do I need the Codex CLI?

Yes — that’s the whole setup. Install it with npm i -g @openai/codex, run codex login once, and CodexUsageBar picks up your sign-in automatically. No cookies, no API keys.

Why do I need to grant Accessibility permissions?

Accessibility permissions are only needed if you want to use the Cmd+U keyboard shortcut to open the popup from anywhere. The app works fine without it – you just won't have the global shortcut.

Does it work with ChatGPT Plus and Pro plans?

Yes! It works with any ChatGPT plan that includes Codex. Your limit windows (5-hour session, weekly) are labeled automatically from what your plan reports, and separately metered models appear once you use them.

The app says "Not signed in" – what do I do?

Run codex login in Terminal, then click Re-check in the popover. If you don’t have the CLI yet, install it first with npm i -g @openai/codex.