dennykim123/claude-codex-battery — explained in plain English
Analysis updated 2026-05-18
Check remaining Claude Code and Codex usage without running /usage manually.
Get a menu bar warning before hitting a Claude Code or Codex usage limit.
See a cost and token breakdown of daily Claude Code usage with ccusage.
| dennykim123/claude-codex-battery | ashertrockman/touchscale | licoy/codex-runway | |
|---|---|---|---|
| Stars | 79 | 82 | 76 |
| Language | Swift | Swift | Swift |
| Last pushed | — | 2015-11-03 | — |
| Maintenance | — | Dormant | — |
| Setup difficulty | easy | easy | easy |
| Complexity | 2/5 | 1/5 | 3/5 |
| Audience | developer | general | developer |
Figures from each repo's GitHub metadata at analysis time.
Native app needs no setup beyond a Claude Code login, the SwiftBar variant needs SwiftBar and bun installed first.
Claude Codex Battery is a macOS menu bar widget that shows how much of your Claude Code and Codex usage allowance you have left, displayed as battery icons so you do not have to keep running the /usage command to check. One battery is labeled C for Claude and another X for Codex, and each one shows the remaining percentage of a usage window, going from full and green when there is plenty left down to red when you are almost out. Clicking the widget opens a dropdown with more detail, including when each limit resets. It ships in two forms. The first is a signed and notarized native Mac app that you can just download and double-click to install, with no other setup needed beyond having Claude Code logged in on the same Mac. The second is a SwiftBar plugin, a single self-contained script with no third-party libraries, which needs SwiftBar and the bun JavaScript runtime installed first. The battery icon images themselves are drawn from scratch in plain JavaScript rather than pulled from an image library. The widget works by calling the official usage endpoints that Anthropic and OpenAI already expose, reusing your existing local login for each tool rather than asking for new credentials. This is the same data shown by Claude Code's own /usage command and Codex's /status command. An optional daily check looks for a newer version of the widget and can install it automatically. The optional ccusage tool can be added for a more detailed cost and token breakdown, but the widget works fully without it. The project is released under the MIT license and only runs on macOS.
A macOS menu bar widget showing remaining Claude Code and Codex usage limits as battery icons, ships as both a native app and a SwiftBar plugin.
Mainly Swift. The stack also includes Swift, JavaScript, Bun.
Use freely for any purpose, including commercial use, as long as you keep the copyright notice.
Setup difficulty is rated easy, with roughly 5min to a first successful run.
Mainly developer.
This repo across BitVibe Labs
double-check against the repo, no cap.