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
TA的项目
+7
日增长
+203
周增长
+755
月增长
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
#3377Tahoe 26.6.2: NSStatusItemScene exists in-process, but Control Center never hosts a layer-25 extra (0.56.3)17 comments · 2026-09-02#4506macOS 27 beta: status item never appears in the menu bar9 comments · 2026-10-13#5074Left/right arrow keys in open merged menu move element focus instead of switching providers on macOS 27 (worked on macOS 26)3 comments · 2026-11-12#5069Muse Code: manual Refresh never prompts for Keychain (0.84.0), and the Keychain Access fallback silently fails on the CLI's partition list3 comments · 2026-11-12#2562Keychain: migrate CodexBar Cache to data-protection keychain and finish prompt-proofing3 comments · 2026-08-01#4132iCloud Sync: other Macs rarely receive updated snapshots — app has no aps-environment / never registers for remote notifications, so CKSyncEngine fetches are no-ops2 comments · 2026-09-29#5095Muse (muse.ai): "Could not find a working muse.ai subscription action" in 0.84.01 comments · 2026-11-15#5094Track subscription-included API credits across OpenAI and Claude Platform with plugin-compatible setup1 comments · 2026-11-15
Latest release
CodexBar 0.84.0 v0.84.0 2026-11-07Highlights - 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