CodexBar

CodexBar is a native macOS menu bar utility that shows Codex usage limits.

Data Source

CodexBar reads ~/.codex/auth.json, extracts the ChatGPT/Codex access token, and requests:

GET https://chatgpt.com/backend-api/wham/usage

It displays the remaining percentage for the primary 5-hour window and the secondary weekly window.

Build

swift build

Test

swift test

Run

Build and launch CodexBar as a proper macOS .app (no Terminal window, no Dock icon):

./scripts/run.sh

scripts/run.sh builds the executable, packages it into build/CodexBar.app with LSUIElement set (so it runs as a background agent app), ad-hoc signs it, and opens it.

Avoid swift run CodexBarApp for normal use: the bare executable runs unbundled, which opens a Terminal window and does not install the menu bar item reliably.

The app runs as an accessory menu bar app and does not write to Codex state, logs, auth files, or caches.