CodexBar 🎚️ - May your tokens never run out.

Tiny macOS 14+ menu bar app that keeps your Codex, Claude, Cursor, Gemini, Antigravity, Droid (Factory), Copilot, z.ai, Kiro, Vertex AI, Augment, Amp, and JetBrains AI limits visible (session + weekly where available) and shows when each window resets. One status item per provider (or Merge Icons mode); enable what you use from Settings. No Dock icon, minimal UI, dynamic bar icons in the menu bar.

<img src="codexbar.png" alt="CodexBar menu screenshot" width="520" />

Install

Requirements

• macOS 14+ (Sonoma)

GitHub Releases

Download: https://github.com/steipete/CodexBar/releases

Homebrew

brew install --cask steipete/tap/codexbar

Linux (CLI only)

brew install steipete/tap/codexbar

Or download CodexBarCLI-v<tag>-linux-<arch>.tar.gz from GitHub Releases. Linux support via Omarchy: community Waybar module and TUI, driven by the codexbar executable.

First run

• Open Settings → Providers and enable what you use.
• Install/sign in to the provider sources you rely on (e.g. codex, claude, gemini, browser cookies, or OAuth; Antigravity requires the Antigravity app running).
• Optional: Settings → Providers → Codex → OpenAI cookies (Automatic or Manual) to add dashboard extras.

Providers

• Codex — Local Codex CLI RPC (+ PTY fallback) and optional OpenAI web dashboard extras.
• Claude — OAuth API or browser cookies (+ CLI PTY fallback); session + weekly usage.
• Cursor — Browser session cookies for plan + usage + billing resets.
• Gemini — OAuth-backed quota API using Gemini CLI credentials (no browser cookies).
• Antigravity — Local language server probe (experimental); no external auth.
• Droid — Browser cookies + WorkOS token flows for Factory usage + billing.
• Copilot — GitHub device flow + Copilot internal usage API.
• z.ai — API token (Keychain) for quota + MCP windows.
• Kimi — Auth token (JWT from kimi-auth cookie) for weekly quota + 5‑hour rate limit.
• Kimi K2 — API key for credit-based usage totals.
• Kiro — CLI-based usage via kiro-cli /usage command; monthly credits + bonus credits.
• Vertex AI — Google Cloud gcloud OAuth with token cost tracking from local Claude logs.
• Augment — Browser cookie-based authentication with automatic session keepalive; credits tracking and usage monitoring.
• Amp — Browser cookie-based authentication with Amp Free usage tracking.
• JetBrains AI — Local XML-based quota from JetBrains IDE configuration; monthly credits tracking.
• Open to new providers: provider authoring guide.

Icon & Screenshot

The menu bar icon is a tiny two-bar meter:

• Top bar: 5‑hour/session window. If weekly is missing/exhausted ...