Claude Codex Battery

🔋 Claude & Codex Usage Battery
A menu-bar and system-tray widget that shows your remaining Claude Code and Codex usage limits as battery icons — so you never have to open /usage again.

C = Claude · X = Codex. Each battery shows the remaining % of a limit window — full & green means plenty left, red means almost out. Click for a detailed breakdown with reset times.

Ships two ways: a notarized native app (double-click install, zero prerequisites) and a single SwiftBar plugin — one self-contained script, no third-party libraries. The battery icons are rendered as PNGs from scratch in pure JavaScript (node:zlib only), so there's no image library and no npm install. Network calls: two official usage endpoints — Anthropic's and OpenAI's — each fetched with your own local Claude Code / Codex login (the same data /usage and Codex's /status show — see Privacy), plus an optional once-a-day update check (see Updating). (ccusage is an optional extra for the cost breakdown.)

What it shows

Click the widget for a dropdown with, per limit:

Colors follow a traffic-light scale: green ≥ 50 % left, amber  Using the native app? Skip this table — it has no prerequisites (Claude Code just needs to be logged in; ccusage optional). The table below is for the SwiftBar-plugin variant.

Note: This widget shows *your own account's* limits — via your local Claude Code login and your local Codex session logs. If you don't use Claude Code (or Codex), there simply won't be any data to display.

Install

Windows (experimental)

The native Windows 10/11 system-tray port lives in windows/. It compiles with the .NET Framework tools included with Windows and requires no Node.js, package manager or Visual Studio installation.

See the Windows documentation for optional start-at-login, privacy controls…