Overview

CodexBar is a lightweight, native macOS menu bar application that helps developers stay on top of their AI coding assistant quotas. It displays session limits, weekly usage, credits, and reset timers for multiple providers in a clean, unobtrusive interface—eliminating the need to repeatedly check browser dashboards or risk hitting unexpected limits mid-workflow.

Built with Swift 6, it supports macOS 14+ (Sonoma and later) on both Apple Silicon and Intel Macs. The app is completely free, open-source under the MIT license, stores no passwords, and updates automatically via Sparkle on GitHub builds.

Key Features

Real-time Quota Monitoring: Session + weekly limits, credits, and precise reset timers for supported providers.
Multiple Providers Supported: Codex (local CLI RPC + web extras), Claude Code, Cursor, Gemini, Antigravity, Droid (Factory), Copilot, z.ai, Kilo, Kiro, Vertex AI, Augment, Amp, JetBrains AI, OpenRouter, Ollama, and more. New providers can be added via the provider guide.
Flexible UI Modes: Individual status items per provider or merged icons with a provider switcher and optional Overview tab.
Dynamic Menu Bar Icons: Visual indicators update live based on usage.
Minimal Footprint: No Dock icon, lightweight design focused on productivity.
Bundled CLI: codexbar command-line tool for scripting, automation, CI/CD, and Linux support.
Privacy-First: No passwords or sensitive credentials stored persistently beyond optional secure caching (e.g., Claude OAuth in Keychain).
Widgets & Extras: Growing support for macOS widgets, historical pacing, risk forecasting, and more.

Installation

Homebrew (Recommended)

brew install --cask steipete/tap/codexbar

GitHub Releases

Download the latest .dmg or app bundle from GitHub Releases. Automatic updates via Sparkle.

Linux CLI Only

brew install steipete/tap/codexbar

Full source code and build instructions available on GitHub.

Use Cases

Heavy AI-assisted coding sessions: Know exactly when your Claude Code or Cursor quota resets.
Multi-provider workflows: Track limits across Codex, Gemini, Copilot, and local models like Ollama in one place.
Team or agency developers: Avoid surprise rate limits during client work.
Automation & Monitoring: Use the CLI in scripts or CI pipelines to query usage programmatically.
Power users: Enable advanced features like historical pace forecasting to predict when you'll hit limits.

Providers & Extensibility

CodexBar is designed to be provider-agnostic. Detailed integration docs for each (including API keys, local CLI, OAuth flows, or web scraping where applicable) are in the repository. Community contributions for new providers are welcome—see docs/provider.md.

Security & Privacy

No passwords stored by default.
Optional secure Keychain usage for OAuth sessions.
Open-source and auditable (MIT license).
Runs locally with minimal network access beyond what's required for quota checks.

CodexBar