Skip to main content

Never run out of AI tokens

CodexBar is a tiny macOS menu bar app that keeps your Codex, Claude, Cursor, Gemini, and other AI assistant limits visible with session and weekly usage meters.

CodexBar menu screenshot showing usage stats

Get started in minutes

Install CodexBar and start tracking your AI usage limits immediately

1

Install CodexBar

Download from GitHub Releases or install via Homebrew:
brew install --cask steipete/tap/codexbar
Requires macOS 14+ (Sonoma).
2

Enable providers

Open Settings → Providers and toggle on the AI assistants you use:
  • Codex (OpenAI)
  • Claude Code
  • Cursor
  • Gemini
  • Copilot
  • And 10+ more providers
Each provider appears as a separate menu bar icon, or use Merge Icons mode to combine them into one.
3

Configure authentication

CodexBar supports multiple authentication methods per provider:
  • CLI integration: Uses your existing codex, claude, or gemini CLI credentials
  • Browser cookies: Reuses your logged-in browser sessions (Safari, Chrome, Firefox)
  • OAuth: Direct API authentication for supported providers
No passwords stored — CodexBar reads from your existing auth sources.
4

Monitor your usage

Click any menu bar icon to see:
  • Session usage percentage and reset time
  • Weekly usage percentage and reset time
  • Credits remaining (where applicable)
  • Cost tracking for last 30 days
# Also available via CLI
codexbar usage --provider claude --format json

Explore by topic

Dive deeper into CodexBar’s features and capabilities

Menu bar interface

Learn how the two-bar meter visualizes session and weekly usage

Multi-provider support

Track 15+ AI coding assistants from a single app

Merge Icons mode

Combine all providers into one menu bar icon with a switcher

CLI commands

Access usage data from scripts and CI pipelines

Privacy & security

Understand how CodexBar handles your credentials

Configuration

Customize refresh cadence, providers, and display options

Ready to track your AI usage?

Download CodexBar and never wonder when your limits reset again. Free and open source under MIT license.

Build docs developers (and LLMs) love