# CodexBar ๐๏ธ โ May your tokens never run out.
> Every AI coding limit, in your menu bar.
[](https://github.com/steipete/CodexBar/releases/latest)
[](https://github.com/steipete/CodexBar/releases/latest)
[](Integrations/Linux/README.md)
[](https://github.com/steipete/homebrew-tap)
[](https://aur.archlinux.org/packages/codexbar-cli)
[](LICENSE)
[](https://codexbar.app)
<a href="https://codexbar.app"><img src="docs/social.png?v=1436859e75bb3a24" alt="CodexBar โ every AI coding limit in your menu bar. 110 providers." width="100%" /></a>
Tiny macOS 14+ menu bar app that keeps **AI coding-provider limits visible** and shows when each window resets. See the [supported providers](#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](Integrations/Linux/README.md) 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.
<img src="docs/codexbar.png" alt="CodexBar menu popover with provider tiles, usage bars, and reset countdowns" width="520" />
## 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](https://github.com/steipete/CodexBar/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](Integrations/Linux/README.md#install-release-archives)
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](Integrations/Linux/MAC_COMPARISON.md) 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<tag>-macos-arm64.tar.gz`, `CodexBarCLI-v<tag>-macos-x86_64.tar.gz`
- Linux (glibc): `CodexBarCLI-v<tag>-linux-aarch64.tar.gz`, `CodexBarCLI-v<tag>-linux-x86_64.tar.gz`
- Linux (static musl): `CodexBarCLI-v<tag>-linux-musl-aarch64.tar.gz`, `CodexBarCLI-v<tag>-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 CodexBar config file. New installs use
`~/.config/codexbar/config.json`; existing `~/.codexbar/config.json` installs still load from the legacy path. You can
script the same provider list that Settings โ Providers uses:
```bash
codexbar config providers
codexbar config enable --provider grok
codexbar config disable --provider cursor
```
For API-key providers, store a key without opening Settings:
```bash
printf '%s' "$ELEVENLABS_API_KEY" | codexbar config set-api-key --provider elevenlabs --stdin
```
`set-api-key` trims the piped value, stores it with restrictive config-file permissions, and enables the provider by default. Use `--no-enable` to only save the key, or `--api-key <key>` for one-off local scripts where shell history is not a concern.
See [CLI configuration](docs/cli-configuration.md) for the full flow.
## Providers
- [Codex](docs/codex.md) โ OAuth API or local Codex CLI, plus optional OpenAI web dashboard extras.
- [OpenAI](docs/openai.md) โ Admin API key usage/cost graphs with legacy credit-balance fallback.
- [Azure OpenAI](docs/azure-openai.md) โ API key, endpoint, and deployment validation probe.
- [Claude](docs/claude.md) โ OAuth API, browser cookies, or CLI PTY fallback; session and weekly usage where available.
- [ClinePass](docs/clinepass.md) โ API key for five-hour, weekly, and monthly subscription limits.
- [Cursor](docs/cursor.md) โ Browser session cookies for plan + usage + billing resets.
- [OpenCode](docs/opencode.md) โ Browser cookies for workspace subscription usage.
- [OpenCode Go](docs/opencodego.md) โ Usage API, browser fallback, and local SQLite cost history.
- [Alibaba Coding Plan](docs/alibaba-coding-plan.md) โ Web cookies or API key for coding-plan quotas.
- [Alibaba Token Plan](docs/alibaba-token-plan.md) โ Bailian browser/manual cookies for token-plan credits.
- [Qwen Cloud](docs/qwen-cloud.md) โ 5-hour and weekly individual Token Plan usage via browser/manual cookies.
- [Gemini](docs/gemini.md) โ OAuth-backed quota API using Gemini CLI credentials (no browser cookies).
- [Antigravity](docs/antigravity.md) โ Local language server probe, `agy` CLI HTTPS source, and Google OAuth fallback (experimental).
- [Droid](docs/factory.md) โ Browser cookies + WorkOS token flows for Factory usage + billing.
- [Copilot](docs/copilot.md) โ GitHub device flow + Copilot internal usage API.
- [Devin](docs/devin.md) โ Chrome localStorage session or manual Bearer token for daily and weekly quotas.
- [z.ai](docs/zai.md) โ API token for personal/team quota, MCP, 5-hour, and hourly usage windows.
- [Manus](docs/manus.md) โ Browser `session_id` auth for credit balance, monthly credits, and daily refresh tracking.
- [MiniMax](docs/minimax.md) โ API token, cookie header, or browser cookies for coding-plan usage.
- [T3 Chat](docs/t3chat.md) โ Browser cookies capture for Base and Overage usage buckets.
- [ZoomMate](docs/zoommate.md) โ Chrome cookie auto-import or manual cURL capture for credits usage.
- [Kimi](docs/kimi.md) โ Auth token (JWT from `kimi-auth` cookie) for weekly quota + 5โhour rate limit.
- [Kilo](docs/kilo.md) โ API token with CLI-auth fallback for Kilo Pass usage.
- [Kiro](docs/kiro.md) โ CLI-based usage; monthly credits + bonus credits.
- [Vertex AI](docs/vertexai.md) โ Google Cloud gcloud OAuth with token cost tracking from local Claude logs.
- [Augment](docs/augment.md) โ Augment CLI or browser cookies for credits tracking and usage monitoring.
- [Amp](docs/amp.md) โ Browser cookie-based authentication with Amp Free usage tracking.
- [Ollama](docs/ollama.md) โ API key access plus browser cookies for Ollama Cloud usage windows.
- [llmman](docs/llmman.md) โ Local daemon memory used by loaded models, with an optional API key.
- [Synthetic](docs/synthetic.md) โ API key quota endpoint for rolling five-hour, weekly token, and search-hourly usage.
- [JetBrains AI](docs/jetbrains.md) โ Local XML-based quota from JetBrains IDE configuration; monthly credits tracking.
- [Warp](docs/warp.md) โ API token for GraphQL request limits and monthly credits.
- [ElevenLabs](docs/elevenlabs.md) โ API key for character credits and voice slot usage.
- [OpenRouter](docs/openrouter.md) โ API token for credit-based usage tracking across multiple AI providers.
- [Windsurf](docs/windsurf.md) โ Browser localStorage session import or local SQLite cache for plan usage.
- [Zed](docs/zed.md) โ Zed editor Keychain session for plan, edit-prediction quota, billing cycle, and overdue invoices.
- [Perplexity](docs/perplexity.md) โ Account usage credits from Perplexity usage data.
- [Xiaomi MiMo](docs/mimo.md) โ Browser cookies for balance and token-plan usage.
- [Doubao](docs/doubao.md) โ API key for Volcengine Ark request-limit probes.
- [Sakana AI](docs/sakana.md) โ Manual Cookie header for 5-hour and weekly quota windows.
- [Abacus AI](docs/abacus.md) โ Browser cookie auth for ChatLLM/RouteLLM compute credit tracking.
- [Mistral](docs/mistral.md) โ Browser cookies for API spend, credit balance, and monthly-plan usage.
- [DeepSeek](docs/deepseek.md) โ API key for credit balance tracking (paid vs. granted breakdown).
- [Fireworks](docs/fireworks.md) โ API key + account slug for 30-day spend from the billing summary API.
- [Charm Hyper](docs/hyper.md) โ Bundled plugin for native Hypercredit balance, using Chrome/manual sessions with API-key fallback.
- [DeepInfra](docs/deepinfra.md) โ API key for prepaid balance, current-month spend, and spending-limit tracking.
- [Moonshot / Kimi API](docs/moonshot.md) โ API key for Moonshot/Kimi API account balance tracking.
- [Venice](docs/venice.md) โ API key for DIEM or USD balance tracking.
- [Codebuff](docs/codebuff.md) โ API token (or `~/.config/manicode/credentials.json`) for credit balance + weekly rate limit.
- [Command Code](docs/command-code.md) โ API key or browser/manual cookies for monthly USD credits and rolling usage limits.
- [Qoder](docs/qoder.md) โ Browser or manual cookies for Qoder big model credit usage.
- [StepFun](docs/stepfun.md) โ Username + password login for Step Plan rate limits (5โhour + weekly windows) and subscription plan name.
- [AWS Bedrock](docs/bedrock.md) โ AWS access keys or a named AWS profile (SSO/assume-role via the AWS CLI) for Cost Explorer spend, monthly budgets, and optional CloudWatch Claude activity.
- [Grok](docs/grok.md) โ Grok CLI billing RPC plus grok.com browser-session fallback.
- [Groq](docs/groq.md) โ Browser session for console spend and usage, with an Enterprise Prometheus API-key fallback.
- [LLM Proxy](docs/llm-proxy.md) โ API key + base URL for aggregate proxy quota stats and provider breakdowns.
- [ClawRouter](docs/clawrouter.md) โ API key for monthly budget, spend, requests, tokens, and routed-provider usage.
- [sub2api](docs/sub2api.md) โ Self-hosted gateway key quota, subscription limits, wallet balance, and per-key usage.
- [Wayfinder](docs/wayfinder.md) โ Local router gateway polling for health, per-route breakdown, savings, and decision latency.
- [LiteLLM](docs/litellm.md) โ Virtual key + proxy URL for personal and team budget/spend tracking.
- [Bifrost](docs/bifrost.md) โ Virtual key + self-hosted gateway URL for budgets, rate limits, and model spend.
- [Aixy](docs/aixy.md) โ API key for key-scoped spend, tokens, and applicable personal/shared budgets.
- [Deepgram](docs/deepgram.md) โ API key usage summaries across speech, agent, token, and TTS metrics.
- [Poe](docs/poe.md) โ API key for current point balance and recent points history.
- [Chutes](docs/chutes.md) โ API key for subscription usage, rolling and monthly quota windows, and pay-as-you-go quotas.
- [Neuralwatt](docs/neuralwatt.md) โ API key for subscription kWh usage and prepaid credit balance.
- [Helmcode](docs/helmcode.md) โ Cloud and NaN Builders dashboard sessions for per-model quotas and Cloud prepaid balance.
- [ZenMux](docs/zenmux.md) โ Management API key for rolling five-hour and seven-day quota windows plus PAYG balance.
- [xAI](docs/xai.md) โ Management API key + team ID for prepaid credit balance and daily platform spend.
- [IBM Bob](docs/ibm-bob.md) โ API key for monthly Bobcoin budget and usage across subscription teams.
- [LongCat](docs/longcat.md) โ Browser or manual cookies for token-pack quota and fuel-pack balances.
- [ai&](docs/aiand.md) โ API key for 30-day organization spend from request logs.
- [Notion AI](docs/notion.md) โ Browser or manual cookies for rolling and monthly workspace allowances.
- [Nous Portal](docs/nous.md) โ Existing Hermes OAuth login for monthly credits and purchased top-ups.
- [Muse Code](docs/muse.md) โ Existing Muse CLI login for subscription quotas, plus local token history.
- [Muse (muse.ai)](docs/museai.md) โ Browser or manual muse.ai session for the Free, Power, or Maximum weekly allowance.
- [CodeRabbit](docs/coderabbit.md) โ Local CLI usage report for review counts, billing state, and period resets.
- [Replicate](docs/replicate.md) โ Browser or manual cookies for monthly spend and optional prepaid credits.
- [Hugging Face](docs/huggingface.md) โ Access token for Inference Providers charges and optional ZeroGPU quota.
- [Raycast](docs/raycast.md) โ Chrome or manual website session for monthly AI credits and renewal.
- [Pi](docs/pi.md) โ Local Pi/OMP transcripts for token history and API-rate cost estimates.
- [v0](docs/v0.md) โ Platform API key for billing and on-demand balances, plus rate limits.
- [TypeSafe](docs/typesafe.md) โ Browser or manual console cookies for billing spend, balance, and credit expirations.
- [GitKraken AI](docs/gitkraken.md) โ Account access token for personal weekly credits, reset time, and organization pool sharing.
- [DevPass](docs/devpass.md) โ API key for plan credits, premium weekly allowances, and key-scoped spending.
- [Atlas Cloud](docs/atlascloud.md) โ API key for the account's available USD balance.
- [Vercel AI Gateway](docs/vercel.md) โ API key for the team's USD balance and lifetime spend.
- [xKiro](docs/xkiro.md) โ API key for daily free-token usage, remaining allowance, and the midnight UTC reset.
- Open to new providers: [provider authoring guide](docs/provider.md).
<!-- Generated provider additions: Scripts/regenerate-provider-docs.mjs -->
- [Langdock](docs/langdock.md) โ Selected Edge, Chrome, or Safari profile โ personal included session and weekly limits (`web`, macOS).
- [Soniox](docs/soniox.md) โ Organization API key for prepaid USD balance and monthly spend against the organization budget.
- [X API](docs/xapi.md) โ Browser or manual console.x.com cookies for prepaid and free credits, including negative balances.
- [Future AGI](docs/futureagi.md) โ API key and secret key (billing-period usage, allowances, and estimated cost).
- [LithosAI](docs/lithosai.md) โ Browser or manual console cookies for prepaid USD balance and optional UTC spend.
- [WorkBuddy](docs/workbuddy.md) โ Chrome or manual www.workbuddy.cn cookies for the monthly credits allowance, plan name, cycle reset, and the platform reward credits.
- [Tavily](docs/tavily.md) โ API key for account-plan, per-key, and pay-as-you-go credit totals.
- [Linkup](docs/linkup.md) โ API key for the current prepaid USD credit balance.
- [TinyApi](docs/tinyapi.md) โ Browser or manual session cookies for aggregate available credits.
- [Exa](docs/exa.md) โ Team Management service key plus an explicit API key ID for month-to-date USD spend.
- [Cosmic AI](docs/cosmic.md) โ Explicit Personal Access Token and Project ID for separate project AI input/output counters and allowances.
- [Aerostack](docs/aerostack.md) โ Explicit account JWT for monthly AI tokens used and the observed account allowance.
- [Sail Research](docs/sailresearch.md) โ API key for organization credit balance and combined inference/Sailbox spend.
- [Sofya](docs/sofya.md) โ API key for separate account plan and purchased credit balances, eligibility, and the reported monthly reset.
- [fal](docs/fal.md) โ API key with billing read access for the current account credit balance.
- [FLORA](docs/flora.md) โ API key with billing permission plus a workspace ID for the available USD balance and month-to-date spend.
- [Parallel](docs/parallel.md) โ Browser session on platform.parallel.ai for the prepaid credit balance and pending debit.
- [Claude Platform](docs/claudeplatform.md) โ Browser or manual platform.claude.com session cookies for Console API credit balance, expiring credit grants, and month-to-date spend.
- [Munito](docs/munito.md) โ Admin API key with Read account data permission for today's and this month's spend against the organization's spend limits.
- [Trae CN](docs/traecn.md) โ Browser session for account credit usage.
- [Chatbox AI](docs/chatbox.md) โ API token
- [abliteration.ai](docs/abliteration.md) โ API key for prepaid USD credits and cumulative usage.
<!-- End generated provider additions -->
## Icon & Screenshot
The menu bar icon is a tiny usage meter. Bar meaning is provider-specific, and errors/stale data can dim the icon or
show an incident indicator.
## Features
- Multi-provider menu bar with per-provider toggles (Settings โ Providers).
- Provider-specific usage meters with reset countdowns.
- Optional Codex web dashboard enrichments (code review remaining, usage breakdown, credits history).
- Inline spend and usage charts for API-backed providers such as OpenAI, Claude Admin API, OpenRouter, LiteLLM, z.ai, MiniMax, Mistral, and AWS Bedrock.
- Codex and Claude Plan Usage menus show a quota burndown from recorded snapshots, with the capture time and an even-use guide. The existing utilization history remains below it, and the line fills in as the app collects samples.
- Configurable cost-usage scans for Codex + Claude, plus reused chart UI for supported provider histories. Codex history uses a WAL-enabled SQLite store capped at 25,000 retained session entries and 256 MiB.
- A persistent Settings โ Usage & Spend view for local estimates, grouped by native currency and provider. Each provider shows its accounts or history sources alongside its model breakdown; project/session views and daily/hourly trends share compact selectors. Incomplete history stays labeled, and source, privacy, export, and sharing controls remain available.
- Provider status polling with incident badges in the menu and icon overlay.
- Merge Icons mode to combine providers into one status item + switcher. With **Icon + Percent** and two enabled built-in providers, choose **Stacked** to show their first layout lines together. Automatic rows follow provider order and reserve explicit choices; disabling a selected provider uses a fallback and restores the saved choice when re-enabled. The dropdown menu stays available, and each provider keeps its own layout settings.
- Display controls for provider icons, labels, bars, reset-time style, and highest-usage auto-selection.
- Fresh installs default to Adaptive refresh. Existing users keep every valid stored choice, while legacy unset or
invalid preferences resolve to 5 minutes. Manual and fixed 1m, 2m, 5m, 15m, and 30m alternatives remain available.
- Bundled CLI (`codexbar`) for scripts and CI (including `codexbar cost --provider codex`, `claude`, or `both` for local cost usage); macOS and Linux CLI builds available.
- WidgetKit widgets for supported providers.
- Localized app and website with a shared 23-language catalog, automatic website detection, persistent pickers, and RTL support.
- Optional session quota notifications and weekly-reset confetti.
- Privacy-first: on-device parsing by default; browser cookies are opt-in and reused (no passwords stored).
## Privacy note
Wondering if CodexBar scans your disk? It doesnโt crawl your filesystem; it reads a small set of known locations (browser cookies/local storage, provider config files, local JSONL logs) when the related features are enabled. Plain Adaptive refresh never inspects local agent activity. The separate Adaptive (agent-aware) option asks before inspecting the running-process list (including command lines) to identify Codex/Claude and reading bounded known-session metadata. Declining returns to plain Adaptive. When allowed with Agent Sessions hidden, CodexBar retains only the latest activity time and discards session paths and identities. Provider tokens and token-account settings live in the CodexBar config file with restrictive file permissions. See the discussion and audit notes in [issue #12](https://github.com/steipete/CodexBar/issues/12).
## macOS permissions (why theyโre needed)
- **Full Disk Access (optional)**: only required to read Safari cookies/local storage for web-based providers. If you donโt grant it, use another supported browser, manual cookies/API keys, OAuth, or CLI/local sources where that provider supports them.
- **Keychain access (prompted by macOS)**:
Chromium cookie import needs the browserโs Safe Storage item, and an explicitly enabled Claude OAuth repair may
read Claude Codeโs own Keychain item. Background CodexBar paths fail or skip instead of requesting authorization;
a user-initiated import or repair can still show the macOS prompt. **Settings โ Advanced โ Disable Keychain
access** blocks CodexBar-owned Keychain operations and browser decryption, but cannot constrain provider-owned CLIs
that CodexBar launches. Manual cookie headers, API keys, and file-backed sources remain alternatives where
supported. See [Keychain prompts](docs/keychain-prompts.md) for Allow Once vs. Always Allow, recurring grants, and
safe troubleshooting.
- **Files & Folders prompts (folder/volume access)**: CodexBar launches provider CLIs and local probes for some providers. If those helpers read a project directory or external drive, macOS may ask CodexBar for that folder/volume (e.g., Desktop or an external volume). This is driven by the helperโs working directory, not background disk scanning.
- **What we do not request in the background**: no Screen Recording or Accessibility permissions; user-triggered helper actions may ask macOS for Automation permission to open Terminal. No passwords are stored (browser cookies are reused when you opt in).
## Docs
- Providers overview: [docs/providers.md](docs/providers.md)
- Provider authoring: [docs/provider.md](docs/provider.md)
- Issue labeling guide: [docs/ISSUE_LABELING.md](docs/ISSUE_LABELING.md)
- UI & icon notes: [docs/ui.md](docs/ui.md)
- CLI reference: [docs/cli.md](docs/cli.md)
- Configuration: [docs/configuration.md](docs/configuration.md)
- Keychain prompts: [docs/keychain-prompts.md](docs/keychain-prompts.md)
- CLI configuration: [docs/cli-configuration.md](docs/cli-configuration.md)
- Widgets: [docs/widgets.md](docs/widgets.md)
- Architecture: [docs/architecture.md](docs/architecture.md)
- Refresh loop: [docs/refresh-loop.md](docs/refresh-loop.md)
- Status polling: [docs/status.md](docs/status.md)
- Sparkle updates: [docs/sparkle.md](docs/sparkle.md)
- Packaging: [docs/packaging.md](docs/packaging.md)
- Development: [docs/DEVELOPMENT.md](docs/DEVELOPMENT.md)
- Release checklist: [docs/RELEASING.md](docs/RELEASING.md)
- Changelog: [CHANGELOG.md](CHANGELOG.md)
## Getting started (dev)
- Clone the repo and open it in Xcode or run the scripts directly.
- Launch once, then toggle providers in Settings โ Providers.
- Install/sign in to provider sources you rely on (CLIs, browser cookies, OAuth/device flow, API keys, or local app/config files).
- Optional: set OpenAI cookies (Automatic or Manual) for Codex dashboard extras.
## Build from source
Requires macOS 14+ and Swift 6.2+.
```bash
./Scripts/package_app.sh # builds CodexBar.app in-place with ad-hoc signing
open CodexBar.app
```
Dev loop:
```bash
./Scripts/compile_and_run.sh
./Scripts/compile_and_run.sh --test # also run the sharded test suite before packaging/relaunching
make check # SwiftFormat + SwiftLint
make docs-list # list docs with frontmatter summaries
```
CLI install:
```bash
# after installing CodexBar.app in /Applications
./bin/install-codexbar-cli.sh
```
## Related
- โ๏ธ [Trimmy](https://github.com/steipete/Trimmy) โ โPaste once, run once.โ Flatten multi-line shell snippets so they paste and run.
- ๐งณ [MCPorter](https://mcporter.dev) โ TypeScript toolkit + CLI for Model Context Protocol servers.
- ๐งฟ [oracle](https://askoracle.dev) โ Ask the oracle when you're stuck. Invoke GPT-5 Pro with a custom context and files.
## Looking for a Windows version?
- [Win-CodexBar](https://github.com/Finesssee/Win-CodexBar)
- [CodexBar for Windows](https://github.com/hinneslung/CodexBar-for-Windows) โ Native Windows tray app powered by the original CodexBar CLI through WSL2; x64 and ARM64 installers.
## Linux desktop integration?
- [Linux desktop app](Integrations/Linux/README.md) โ x86_64/ARM64 release archives with an installer; Qt 6 usage and spending windows, separate settings, optional system tray, and desktop notifications using the Linux CLI.
- [Omarchy native widget](Integrations/Omarchy/README.md) โ Compact Quickshell usage popup sharing the Linux desktop appโs backend.
- [CodexBar GTK](https://github.com/SaahiilM/codexbar-gtk) โ Community GTK4/libadwaita front-end with usage, spending, and agent sessions from the CodexBar Linux CLI.
- [codexbar-waybar](https://github.com/Marouan-chak/codexbar-waybar) โ Waybar custom module + GTK4 popover for Hyprland / Sway / other Wayland compositors, built on top of the bundled Linux CLI.
- [codexbar-cosmic-applet](https://github.com/andrew-verde/codexbar-cosmic-applet) โ Native COSMIC (System76) desktop panel applet with a tab per provider, pace projections, and cost/token stats, built on top of the bundled Linux CLI.
- [Codexbar GNOME](https://extensions.gnome.org/extension/9841/codexbar/) โ GNOME Shell extension that brings CodexBar usage into the desktop panel.
- [codexbar-cinnamon-applet](https://github.com/jacobcalvert/codexbar-cinnamon-applet) โ Linux Mint Cinnamon panel applet powered by CodexBar's JSON output.
- [noctalia-codex-usage](https://github.com/rayoplateado/noctalia-codex-usage) โ Noctalia/Quickshell plugin that shows Codex 5-hour and weekly usage limits, built on top of the bundled Linux CLI.
- [KodexBar](https://github.com/tylxr59/KodexBar) โ KDE Plasma widget that shows CodexBar usage in the Plasma panel, built on top of the bundled Linux CLI.
- [codexbar-plasmoid](https://github.com/psimaker/codexbar-plasmoid) โ KDE Plasma 6 widget for CodexBar's meter icon, provider switcher, quota windows, pace, credits, local cost, and status, powered by the bundled Linux CLI.
- [CodexBar Plasma](https://github.com/Lucenx9/codexbar-plasma) โ KDE Plasma 6 widget with multi-provider views, account selection, cost history, notifications, configurable providers, and installable `.plasmoid` releases, powered by the bundled Linux CLI.
- [CodexBar AgentView](https://github.com/materemias/codexbar-agentview) โ KDE Plasma 6 widget with usage meters, agent-session search, terminal focus, and kitty session restoration, powered by the bundled Linux CLI.
- [CodexBar Meter](https://github.com/noctalia-dev/community-plugins/tree/main/codexbar-meter) โ Noctalia v5 bar widget and panel showing every enabled provider's quota windows, credits, and pace, installable from Noctalia's plugin store, built on the bundled Linux CLI.
- [codexbar-dms](https://github.com/quantmind-br/codexbar-dms) โ DankMaterialShell bar widget with provider logo pills, a popout of quota windows, reset times, and local spending, and shortcuts to the Linux desktop app's Usage & Spend and Settings windows, sharing that app's backend.
## Desk display
- [AI Monitor](https://github.com/tobymarks/esp32-ai-monitor) โ ESP32 desk display (Cheap Yellow Display) plus a macOS companion app that shows Claude, ChatGPT, Gemini, Copilot, Cursor and Antigravity limits as rings or bars, fed over USB by the bundled CLI. No Wi-Fi on the device, 3D-printable case.
- [TokenTV](https://github.com/click6067-ship-it/token-tv) โ Python host that shows Claude and Codex 5-hour and weekly limits on compatible 240ร240 Wi-Fi desk clocks (GeekMagic SmallTV style), using the bundled CLI or `codexbar serve`. It uploads rendered screens to the clock's stock photo album without changing its firmware.
## Status bar & terminal integration
- [showy-quota](https://github.com/enieuwy/showy-quota) โ always-on AI plan quota strips for SketchyBar, tmux, and Zellij (standalone WASM plugin), built on `codexbar serve` / the bundled CLI.
- [AI Usage Limits](https://github.com/lenadweb/stream-deck-ai-limits) โ Elgato Stream Deck integration for macOS: shows a selected CodexBar provider, account, and configurable quota or payload metrics on keys and Stream Deck+ dials, using local `codexbar serve`.
- [ccx](https://github.com/aaronwong1999/ccx) โ macOS menu bar companion for Claude Code/Codex task handoff, using `codexbar usage --provider both --format json` for quota warnings.
## Phone & web
- [Starbridge](https://github.com/T0mSIlver/starbridge) โ Community-maintained Android and web app that displays quota windows from the CodexBar CLI on macOS and Linux, with optional quota alerts.
- [Notify! CodexBar](https://github.com/simplytoast1/notify-codexbar) โ Community-maintained macOS companion that reads CodexBar CLI or local `codexbar serve` output and sends selected usage through [Notify!](https://getnotifyapp.com/) for iPhone/iPad widgets, Live Activities, and quota notifications.
## Credits
Inspired by [ccusage](https://github.com/ryoppippi/ccusage) (MIT), specifically the cost usage tracking.
## License
MIT โข Peter Steinberger ([steipete](https://twitter.com/steipete))