steipete/CodexBar: Show usage stats for OpenAI Codex and Claude Code, without having to login.

Show usage stats for OpenAI Codex and Claude Code, without having to login. - steipete/CodexBar

Summary

CodexBar is a macOS 14+ menu bar application (with a Linux Qt 6 desktop counterpart) that surfaces AI coding subscription usage from many providers without needing you to log in to each web dashboard. It reuses existing sessions — OAuth, browser cookies, CLI auth, or API keys — to display usage meters, reset countdowns, credit balances, and provider status in a single status item. The project ships as Swift source under the MIT license and bundles a codexbar CLI for scripts and CI.

What it is useful for

• Watching session, weekly, and monthly usage windows across many AI coding services (Codex, Claude, Cursor, Copilot, Gemini, OpenRouter, z.ai, and others) from one place, with countdowns to each reset.
• Tracking credits, spend, and Admin API cost graphs for API-backed providers (OpenAI, Claude Admin API, AWS Bedrock, OpenRouter, LiteLLM) without opening a browser tab.
• Surfacing provider status in real time — the menu shows incident badges and the bar icon dims or shows an overlay when data is stale or a provider reports an incident.
• Driving scripts and CI that need local cost or quota data: the README describes codexbar cost --provider codex|claude|both for local cost usage.
• Extending to Linux desktops and Wayland setups via the Qt 6 app, an Omarchy widget, and third-party Waybar, COSMIC, and GNOME integrations that wrap the bundled CLI.

How engineers can use it

On macOS, install the cask and enable the providers you use:

brew install --cask codexbar

Open the app, go to Settings → Providers, and toggle the providers you rely on. Authentication reuses existing sources: sign in to the Codex or Claude Code CLIs, allow browser cookie import, complete OAuth or device flow, or set an API key. The README notes Full Disk Access is optional and only required to read Safari cookies; other browsers, manual cookies, API keys, or OAuth are alternatives.

For headless or scripted use, install the CLI:

brew install steipete/tap/codexbar     # macOS/Linux
yay -S codexbar-cli                   # Arch Linux AUR

Configure providers and keys without opening the GUI:

codexbar config providers
codexbar config enable --provider grok
printf '%s' "$ELEVENLABS_API_KEY" | codexbar config set-api-key --provider elevenlabs --stdin

To build from source you need macOS 14+ and Swift 6.2+, then run ./Scripts/package_app.sh and open CodexBar.app. Full provider-by-provider setup steps live in the README under docs/.

Limitations to keep in mind: the macOS GUI requires Sonoma or newer; Linux release archives need glibc 2.39+ and Qt 6.4+; GNOME may require a tray extension; some providers depend on browser cookie imports or device flow that the README documents per provider. The project states it does not store passwords and runs on-device parsing by default, with an opt-in "agent-aware" mode that asks before inspecting running processes.