Skip to content
Get packs

CodexBar

A menu bar app (plus CLI) that shows your AI coding tool usage limits and reset times.

GitHub Download v0.83.0
Stars
22.9k
Forks
2.2k
Licence
MIT
Language
Swift
Last update
6 days ago
Type
App

What it is

CodexBar is a small menu bar app for macOS that shows how much of your AI coding provider limits you have used and when each limit resets. It supports a long list of providers, including OpenAI Codex and Claude Code as named in its description. It reuses existing provider sessions such as OAuth, API keys, browser cookies, or local CLI files, and the README says it does not store passwords. A Linux desktop app and a CLI are also available.

  • See your Codex or Claude usage windows and reset countdowns from the menu bar
  • Track API spend or credit balances for supported providers such as OpenAI or OpenRouter
  • Check provider incident status shown as badges in the menu
  • Set API keys and enable providers from the command line with the codexbar config commands

Great for

  • Developers who use several AI coding tools and want to see remaining limits at a glance
  • People on usage-capped subscription plans who want to plan long tasks around reset times
  • Mac users who prefer a menu bar indicator over a web dashboard
  • Linux users who want the CLI or the Qt desktop app

Not ideal for

  • Users on platforms other than macOS or Linux, since the README lists no Windows support
  • People who do not want any app reading provider session cookies or local files, since the README says it reuses browser cookies and local files for many providers
  • Users of providers outside the README's list, since it covers only the providers it names
Step-by-step guide: how to use CodexBarInstall, first run, examples, tips and FAQs
CodexBar alternativesCC Switch vs CodexBarCodexBar vs OrcaCodexBar vs OmniRoute

How to get it

  1. 1

    Install with a package manager

    You'll need: macOS 14+ (Sonoma) for the menu bar app · Homebrew for the brew install command · Linux: glibc 2.39+ and Qt 6.4+ for the desktop app

    Install the macOS app with Homebrew

    brew install --cask codexbar

    Install the CLI on Linux with Homebrew

    brew install steipete/tap/codexbar

    Install the CLI from the AUR on Arch Linux

    yay -S codexbar-cli
  2. 2

    Run it

    • Install the macOS app or the CLI using one of the commands above.
    • Open Settings → Providers in the app and enable the providers you use.
    • Install or sign in to each provider's source, such as its CLI, browser session, or API key.
    • Optionally add OpenAI cookies under Settings → Providers → Codex for dashboard extras.
  3. 3

    Get the most out of it

    • Use codexbar config enable and disable to script which providers are shown.
    • Use codexbar config set-api-key with --stdin to store API keys without leaving them in shell history.
    • Use Merge Icons mode with the provider switcher if you want one menu bar item instead of one per provider.
    • Read the per-provider docs linked in the README for the exact auth method each provider needs.

Downloads

Source code (.zip)main branch · straight from GitHubRelease v0.83.08 files incl. CodexBar-macos-universal-0.83.0.zip.sha256Official website & docscodex.bar

Strengths

  • Shows usage limits and reset times in one place across many providers
  • Reuses existing sessions and states that no passwords are stored
  • Available as a macOS menu bar app, a Linux desktop app, and a CLI

Trade-offs

  • Each provider needs its own setup (CLI login, cookies, or API key), and some depend on browser sessions that may change
  • The README describes some providers as experimental or partial, such as Antigravity
  • Linux desktop needs glibc 2.39+, Qt 6.4+, and a separate CLI install

How it compares

ProjectStarsTypeLevelUpdatedBest for
CodexBar (this)22.9kAppbeginner6 days agoDevelopers who use several AI coding tools and want to see remaining limits at a glance
cc-switch151kAppbeginner4 days agoDevelopers who use several AI coding agents and switch between API providers often
orca113kAppintermediate4 days agoDevelopers who already use CLI coding agents and want to run several at once
OmniRoute83.8kAppintermediate4 days agoDevelopers who use several AI coding tools and want one place to configure providers
CLIProxyAPI57.3kAppintermediate4 days agoDevelopers who already use OpenAI- or Claude-compatible tools and want to route them to other providers
magpie28.2kAppintermediate4 days agoPeople who use more than one AI coding agent and want one place to manage their models

Stats synced from GitHub. The assessment above was drafted with AI from the project's README on 2026-10-29 and may miss recent changes — check the README before relying on a command. MIT licence: free to use, modify and distribute, including commercially, as long as you keep the copyright notice.