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