steipete /CodexBar

Show usage stats for OpenAI Codex and Claude Code, without having to login.

★ 23,171⑂ 2,233👁 57⑃ 3,453● 1,627▤ 156
SwiftMITCreated 2025-11-16codex.bar
More from this author
Download: CodexBar 0.84.0CodexBar-0.84.0 ↓0.84.02026-11-07
+7
Daily
+203
Weekly
+755
Monthly
23,171
stars
2,233
forks
57
watchers
3,453
prs
1,627
issues
156
releases

README

CodexBar 🎚️ — May your tokens never run out.

 Every AI coding limit, in your menu bar.











Tiny macOS 14+ menu bar app that keeps AI coding-provider limits visible and shows when each window resets. See the supported providers below. One status item per provider, or Merge Icons mode with a provider switcher. No Dock icon, minimal UI, dynamic bar icons.

Also available as a Linux desktop app with usage and spending windows, separate settings, desktop notifications, and an optional tray icon. On Omarchy, a native bar widget shares the desktop app’s data and follows your theme.



 Why

- Plan around resets. Per-provider session, weekly, and monthly windows with countdowns to the next reset — stop guessing whether to start that long task.
- Credits, spend, and cost scans. Credit balances, Admin API spend dashboards, provider billing summaries, and local cost scans where the source exposes enough detail.
- Live status. Provider status polling surfaces incident badges in the menu and an indicator overlay on the bar icon.
- Privacy-first. Reuses existing provider sessions — OAuth, device flow, API keys, browser cookies, local files — so no passwords are stored.

 Install

 macOS app

Requires macOS 14+ (Sonoma). Download from GitHub Releases, or install with Homebrew:

bash
brew install --cask codexbar


 Linux desktop and Omarchy

The Qt 6 desktop app supports Wayland and X11, with an optional Omarchy widget.
Published desktop archives target x86_64 and ARM64 and require glibc 2.39+,
Qt 6.4+, and a separately installed CodexBar CLI. Python 3 runs the per-user installer.

Follow the Linux installation guide
for Arch/Omarchy, Fedora, and Debian/Ubuntu runtime packages, verified release
downloads, and upgrades. It keeps the CLI's resource bundle beside its executable
and installs a launcher and optional login startup. Open Settings to choose
providers, then authenticate through the provider's CLI or configure its API key.
GNOME may need a tray extension; the app's windows work without a tray.

See the macOS feature comparison for
supported features and remaining gaps.

 CLI Tarballs (macOS/Linux)
Homebrew formula (Linux today):
bash
brew install steipete/tap/codexbar

Arch Linux AUR package:
bash
yay -S codexbar-cli

Or download release tarballs from GitHub Releases:
- macOS: CodexBarCLI-v-macos-arm64.tar.gz, CodexBarCLI-v-macos-x86_64.tar.gz
- Linux (glibc): CodexBarCLI-v-linux-aarch64.tar.gz, CodexBarCLI-v-linux-x86_64.tar.gz
- Linux (static musl): CodexBarCLI-v-linux-musl-aarch64.tar.gz, CodexBarCLI-v-linux-musl-x86_64.tar.gz

 macOS first run
- Open Settings → Providers and enable what you use.
- Install/sign in to the provider sources you rely on: CLIs, browser sessions, OAuth/device flow, API keys, local app files, or provider apps depending on the provider.
- Optional: Settings → Providers → Codex → OpenAI cookies (Automatic or Manual) to add dashboard extras.

 Set API keys from the CLI
Provider toggles and API keys live in the resolved C

Top issues

Latest release

CodexBar 0.84.0 v0.84.0 2026-11-07
Highlights

- Memory and CPU: a long pass through refresh and UI work. In synthetic tests, first opening Usage & Spend uses about half the CPU and far less memory (about 680 to 118 MiB), plugin refreshes use about 60% less CPU, unchanged cost refreshes about 72% less, and ordinary Claude history cycles settle much lower (312 to 57 MB). On recent macOS, the packaged app also holds on to less freed memory, and widgets skip duplicate writes and reloads.
- Cost history: Claude and Codex history stay complete through symlinked directories, Claude and Vertex avoid most of the midnight rescan, AWS Be

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON