dennykim123/claude-codex-battery

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.