Repolode
Submit
steipete

steipete/CodexBar

A macOS menu bar app that shows usage limits, reset times, and spend for 100+ AI coding and API providers, without storing passwords.

View on GitHubWebsite
Stars
22,656
Forks
2,141
Open issues
59
Last commit
3 hours ago

What is it?

CodexBar is a small macOS menu bar app, with a Qt-based Linux desktop version and a bundled CLI, that keeps AI coding provider limits visible. For each provider it shows session, weekly, or monthly usage windows with countdowns to the next reset, so you can see whether there is room for a long task before starting it.

It covers a wide range of services, including Codex, Claude, Cursor, Gemini, Copilot, OpenRouter, and many API gateways. Depending on the provider, it reads OAuth or API keys, browser cookies, CLI output, or local files, and it does not store passwords. Provider status polling adds incident badges to the menu and bar icon.

Beyond quota meters, it can show credit balances, spend charts for API-backed providers, and local cost scans for Codex and Claude. Scripts and CI can use the `codexbar` CLI, and `codexbar serve` feeds third-party widgets and desk displays.

Key features

  • 01Shows session, weekly, and monthly usage windows with reset countdowns per provider.
  • 02Supports OAuth, API keys, browser cookies, CLI output, and local files for authentication.
  • 03Displays provider status incidents in the menu and on the bar icon.
  • 04Charts spend and usage for API-backed providers and scans local Codex and Claude costs.
  • 05Includes a CLI for scripts and CI, plus WidgetKit widgets on macOS.

Use cases

  • Checking remaining Claude or Codex limits before starting a long coding session.
  • Tracking API spend across OpenAI, OpenRouter, or LiteLLM from the menu bar.
  • Feeding usage data into a desk display, Stream Deck, or status bar through the CLI.
  • Monitoring several AI coding subscriptions in one place on macOS or Linux.

Quick start

  1. 1

    Install the macOS app with Homebrew

    brew install --cask codexbar
  2. 2

    Open Settings and enable the providers you use, then sign in to their sources

Things to know

  • macOS 14+ only for the menu bar app; Linux uses a separate Qt desktop app.
  • Each provider needs its own sign-in, API key, or browser session before it shows usage.

Topics

#ai#menu-bar#macos#usage-monitoring#claude-code#codex#api-spend#swift

FAQ

What is CodexBar?
A macOS menu bar app that shows usage limits, reset times, and spend for 100+ AI coding and API providers, without storing passwords. CodexBar is a small macOS menu bar app, with a Qt-based Linux desktop version and a bundled CLI, that keeps AI coding provider limits visible. For each provider it shows session, weekly, or monthly usage windows with countdowns to the next reset, so you can see whether there is room for a long task before starting it.
Is CodexBar free to use? What license does it have?
CodexBar is open source under the MIT license. Check the license terms before using it in commercial products.
Is CodexBar still maintained?
Actively maintained. The last commit to CodexBar was on Oct 19, 2026.
What can I use CodexBar for?
Checking remaining Claude or Codex limits before starting a long coding session. Tracking API spend across OpenAI, OpenRouter, or LiteLLM from the menu bar. Feeding usage data into a desk display, Stream Deck, or status bar through the CLI. Monitoring several AI coding subscriptions in one place on macOS or Linux.
How do I install CodexBar?
Install the macOS app with Homebrew: brew install --cask codexbar Open Settings and enable the providers you use, then sign in to their sources
Where can I get CodexBar?
The source code and installation instructions are on GitHub: https://github.com/steipete/CodexBar

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects