gitwtfhub

wtf is codexbar?

steipete/codexbar — explained in plain English

Analysis updated 2026-05-18

18,852SwiftAudience · developerComplexity · 2/5LicenseSetup · easy

TL;DR

A macOS menu bar app that shows your usage limits, resets, and spend across dozens of AI coding tools like Codex, Claude, and Cursor without needing new logins.

Mindmap

mindmap
  root((CodexBar))
    What it does
      Shows AI usage limits
      Reset countdown timers
      Live provider status
    Tech stack
      Swift
      macOS menu bar
      CLI tool
    Use cases
      Track Codex or Claude usage
      Watch multiple provider limits
      Monitor spend and credits
    Audience
      Developers
      AI power users

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Check how much Codex, Claude, or Cursor usage you have left before starting a long coding session.

REASON 2

Track credit balances and spend across dozens of AI providers from one menu bar app.

REASON 3

Get notified when a provider has a status incident without checking each dashboard separately.

REASON 4

Manage provider API keys and settings from the command line instead of clicking through a UI.

What's in the stack?

SwiftmacOSHomebrewCLI

How it stacks up

steipete/codexbarrealm/swiftlintp0deje/maccy
Stars18,85219,56719,844
LanguageSwiftSwiftSwift
Setup difficultyeasyeasyeasy
Complexity2/52/51/5
Audiencedeveloperdevelopergeneral

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · easy Time to first run · 5min

Requires macOS 14 or newer, each provider needs its own sign-in method (OAuth, API key, or browser cookies).

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

Wtf does this do

CodexBar is a small menu bar app for Mac, built with Swift, that keeps track of your usage limits across many different AI coding tools and services in one place. Instead of logging into each provider's website to check how many messages, credits, or tokens you have left, CodexBar shows that information right in your Mac's menu bar. It supports a very wide range of providers, including Codex, OpenAI, Claude, Cursor, Gemini, Copilot, Grok, GroqCloud, ElevenLabs, and dozens of others, each with its own way of pulling usage data. For each one, it shows countdowns until your session, weekly, or monthly usage window resets, so you know whether it is safe to start a long task or whether you are about to hit a limit. Where a provider exposes the information, CodexBar also shows credit balances, spend dashboards, billing summaries, and live status incidents, with a small badge appearing on the icon when something is wrong. A key design choice is that CodexBar does not ask you to create new accounts or store separate passwords. It reuses sessions you already have, whether that is an existing OAuth login, a device flow, an API key, browser cookies, or local files the provider's own app already created on your computer. You can install it as a downloadable Mac app from GitHub Releases or through Homebrew, or install a command line version through Homebrew or the Arch Linux AUR, with prebuilt versions available for both macOS and Linux. After installing, you turn on the providers you use from a Settings screen, and sign in to each one the way that provider expects, whether through its CLI, browser, or an API key. There is also a command line tool for managing provider settings and storing API keys directly from a script, which is useful if you want to automate this setup rather than clicking through the Settings window. CodexBar requires macOS 14 or newer for the menu bar app, and is released under the MIT license, meaning it can be used freely, including commercially, as long as the copyright notice is kept.

Yoink these prompts

Prompt 1
Walk me through installing CodexBar on macOS with Homebrew and enabling the Claude and Codex providers.
Prompt 2
Show me how to set an ElevenLabs API key for CodexBar using the CLI without opening Settings.
Prompt 3
Explain how CodexBar tracks usage without me storing new passwords for each AI provider.
Prompt 4
What is the difference between CodexBar's menu bar app and its CLI tarball installs?

Frequently asked questions

wtf is codexbar?

A macOS menu bar app that shows your usage limits, resets, and spend across dozens of AI coding tools like Codex, Claude, and Cursor without needing new logins.

What language is codexbar written in?

Mainly Swift. The stack also includes Swift, macOS, Homebrew.

What license does codexbar use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is codexbar to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is codexbar for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.