steipete/CodexBar

CodexBar – AI‑coding‑quota monitor for macOS (and CLI for Linux)

What it is – A tiny macOS 14+ menu‑bar app (with a bundled command‑line tool) that shows, in real time, how many tokens/credits you have left for each AI‑coding provider you use (OpenAI, Claude, Gemini, Copilot, Grok, etc.). It also displays when the provider’s usage window resets (daily, weekly, monthly) and can surface spend/credit balances.

Why you might want it

Avoid surprises – See countdowns to quota resets so you can plan long‑running code‑generation tasks.
Cost awareness – Inline charts of API spend and credit balances for providers that expose that data.
Live status – Provider‑status polling adds incident badges directly on the menu icon.
Privacy‑first – Re‑uses existing sessions (OAuth, API keys, browser cookies) and never stores passwords; only reads a few known files when you enable a provider.

Key features (as described in the README)

One status item per provider, or a Merge Icons mode that collapses them into a single icon with a switcher.
Provider‑specific usage meters with reset countdowns.
Cost/usage charts for API‑backed providers (OpenAI, Claude Admin API, OpenRouter, LiteLLM, etc.).
Persistent Usage & Spend view with 7‑/30‑day estimates, grouped by native currency.
Provider status polling with incident badges.
Configurable refresh intervals (adaptive default, plus fixed 1 m‑30 m options).
Bundled CLI (codexbar) for scripting and CI (e.g., codexbar cost --provider openai).
WidgetKit widgets for supported providers.
Localized UI (21 languages) and RTL support.
Optional notifications for quota resets.
No Dock icon; minimal UI that lives entirely in the menu bar.

Supported providers – The app ships with built‑in support for more than 60 providers, ranging from OpenAI, Claude, Gemini, and Azure OpenAI to niche services like ElevenLabs, Deepgram, Zed, JetBrains AI, AWS Bedrock, GroqCloud, LiteLLM, and many others. Adding a new provider is possible via the documented provider authoring guide.

Installation

macOS – Download a release from the GitHub releases page or install via Homebrew Cask:
```
brew install --cask codexbar
```
Linux – Install the CLI via Homebrew (brew install steipete/tap/codexbar) or the Arch AUR (yay -S codexbar-cli). Tarballs for various architectures are also available.
First‑run – Open Settings → Providers and enable the services you use. Provide API keys, OAuth credentials, or browser cookies as required. API keys can be set from the CLI, e.g.:
```
printf '%s' "$ELEVENLABS_API_KEY" | codexbar config set-api-key --provider elevenlabs --stdin
```

Permissions – The app may request:

Full Disk Access (optional) to read Safari cookies for web‑based providers.
Keychain access to decrypt Chromium cookies or read stored OAuth tokens.
Folder/volume access when launching external provider CLIs. All prompts are explained in the README, and you can disable keychain reads entirely in the advanced settings.

Development – Built with Swift 6.2+ for macOS 14+. The repo includes scripts to package the app, run tests, lint, and generate documentation. A CLI binary is also built for macOS and Linux.

Related projects – The author also maintains Trimmy (a clipboard‑run helper), MCPorter (TypeScript toolkit for Model Context Protocol), and oracle (a GPT‑5‑style query tool). Community ports exist for Windows, Wayland, COSMIC, GNOME, and Cinnamon.

All information above is taken directly from the repository’s README; no additional features have been inferred.