Codexbar
Show usage stats for OpenAI Codex and Claude Code, without having to login.
Last verified:
What is Codexbar?
CodexBar is a tiny, free, and open-source macOS menu bar application designed to help developers and AI power users monitor usage limits across multiple AI coding tools from a single interface. It tracks session and weekly usage limits, reset times, credits, costs, and provider status for 40+ AI coding providers including Codex (OpenAI), Claude Code, Cursor, Gemini, Copilot, Grok, GroqCloud, z.ai, MiniMax, Kiro, Vertex AI, Augment, OpenRouter, and many more.
Key features include per-provider usage meters with countdown timers to the next reset, inline spend and usage charts for API-backed providers, provider status polling with incident badges, Merge Icons mode to combine all providers into one menu bar icon, a bundled CLI for scripting and CI automation, WidgetKit widgets for supported providers, optional session quota notifications, and configurable refresh cadences (manual, 1m, 2m, 5m, 15m, 30m). The app displays a two-bar meter showing session/5-hour window usage (top bar) and weekly window usage (bottom hairline bar).
CodexBar is privacy-first: it reuses existing provider sessions through OAuth, device flow, API keys, browser cookies, and local files without storing any passwords. All data processing happens on-device, and browser cookie access is opt-in. The app is built with Swift 6, requires macOS 14+ (Sonoma and later), supports both Apple Silicon and Intel Macs, and is completely free under the MIT license with automatic updates via Sparkle.
The tool is ideal for developers who rely on multiple AI coding assistants and want better visibility into quotas, provider incidents, and remaining usage without repeatedly checking browser dashboards. It supports authentication via CLI tools (codex, claude, gemini), browser cookies (Safari, Chrome, Firefox), and OAuth, making it accessible for both casual users and those who need CI pipeline integration.
Codexbar pricing
Pricing model: Freemium
Completely free and open-source under the MIT license. There are no paid plans, subscriptions, or premium tiers. All features including multi-provider tracking, CLI access, widgets, cost tracking, and status polling are included at no cost. The app is available via GitHub Releases, Homebrew (brew install --cask codexbar), and CLI tarballs for macOS and Linux.
Codexbar pros
- Completely free and open-source under MIT license
- Tracks 40+ AI coding providers from one menu bar app
- No passwords stored - reuses existing authentication
- Session and weekly usage meters with reset countdowns
- Built-in CLI for scripts and CI automation
- Merge Icons mode combines all providers into one icon
- Provider status polling shows incident badges
- Inline spend and usage charts for API-backed providers
- WidgetKit widgets available for supported providers
- Configurable refresh cadence (manual to 30m)
- Optional session quota notifications and reset confetti
- On-device parsing ensures privacy
- Supports both Apple Silicon and Intel Macs
- Automatic updates via Sparkle
- Lightweight with no Dock icon
- Cost tracking for last 30 days
- Cross-platform CLI available for macOS and Linux
- Multiple authentication methods per provider
Codexbar cons
- macOS only - requires macOS 14+ (Sonoma)
- No Windows or native Linux desktop app
- Full Disk Access required for Safari cookies
- Keychain access prompts may require manual configuration
- Some providers are experimental (e.g., Antigravity)
- Browser cookie access is opt-in and requires permissions
- No mobile app for iOS or Android
- Kernel-level permissions needed for some features
Frequently asked questions about Codexbar
What is CodexBar?
CodexBar is a tiny macOS menu bar app that tracks AI coding-provider usage limits, credits, costs, and reset times across 40+ providers including Codex, OpenAI, Claude, Cursor, Gemini, Copilot, and many more. It displays session and weekly usage meters directly in your menu bar with countdowns to the next reset, eliminating the need to repeatedly check browser dashboards.
Is CodexBar free?
Yes, CodexBar is completely free and open-source under the MIT license. There are no paid plans, subscriptions, or premium features. All functionality including multi-provider tracking, CLI access, widgets, cost tracking, and provider status polling are included at no cost.
What operating systems does CodexBar support?
CodexBar requires macOS 14+ (Sonoma) and runs on both Apple Silicon and Intel Macs. There is no native Windows or macOS-less Linux desktop app, though CLI tarballs are available for macOS and Linux, and community-built alternatives exist like Win-CodexBar for Windows and codexbar-waybar for Wayland compositors.
How does CodexBar authenticate with AI providers?
CodexBar supports multiple authentication methods per provider: CLI integration (reuses your existing codex, claude, gemini CLI credentials), browser cookies (Safari, Chrome, Firefox sessions), and OAuth/device flow. It reuses your existing authentication without storing any passwords, making it privacy-first.
Does CodexBar store my passwords or API keys?
No, CodexBar does not store any passwords. It reuses your existing provider sessions through OAuth, device flow, API keys, browser cookies, and local files. All data processing happens on-device, and browser cookie access is opt-in. Provider tokens are stored in ~/.codexbar/config.json with restrictive file permissions.
How many AI providers does CodexBar support?
CodexBar supports 40+ AI coding providers including Codex (OpenAI), Claude Code, Cursor, Gemini, Copilot, Grok, GroqCloud, ElevenLabs, Deepgram, z.ai, MiniMax, Kiro, Vertex AI, Augment, OpenRouter, LLM Proxy, Codebuff, Command Code, AWS Bedrock, Manus, Kimi, JetBrains AI, Warp, Perplexity, Mistral, DeepSeek, and many more. New providers can be added via the provider authoring guide.
What is the difference between the top and bottom bars in the menu icon?
The two-bar meter displays: the top bar shows session or 5-hour window usage (0-100%), while the bottom bar shows weekly window usage as a thin hairline (0-100%). A thicker top bar indicates credits remaining when weekly usage is exhausted. Clicking the icon reveals detailed metrics including session/weekly percentages, reset countdowns, credits remaining, and account/plan details.
How do I install CodexBar?
You can install CodexBar via Homebrew with 'brew install --cask codexbar', download from GitHub Releases, or use CLI tarballs. After installation, open Settings → Providers to enable the AI assistants you use, then configure authentication via CLI tools, browser cookies, or OAuth depending on your provider.
What is Merge Icons mode?
Merge Icons mode combines all enabled providers into a single menu bar icon with a provider switcher. To enable it, go to Settings → General and toggle Merge Icons. You can click the unified icon to switch between providers, and enabling the Overview tab lets you see up to 3 providers at once instead of having separate icons for each.
How do I use the CodexBar CLI?
Install the CLI via Settings → Advanced → Install GUI, or manually link it. Then run commands like 'codexbar' to check usage, 'codexbar --provider claude' for a specific provider, 'codexbar --format json --pretty' for JSON output, 'codexbar cost --provider codex' for cost tracking, or 'codexbar --provider all' for all providers. The CLI is useful for scripting and CI pipelines.