Claude Code usage

Battery

A macOS menu bar app that monitors your Claude Code API usage in real time.

Install

Install
brew install --cask claude-battery

Found in the project README. Check it for setup steps after installing.

From source
git clone https://github.com/allthingsclaude/battery.git

From the README

Battery
by All Things Claude

A macOS menu bar app that monitors your Claude Code API usage in real time.

Battery lives in your menu bar and shows how much of your Claude Code rate limit you've used across both the 5-hour session window and the 7-day weekly window. It helps you pace your usage, avoid hitting limits unexpectedly, and stay informed about your consumption patterns.

Features

- Session & weekly gauges - Circular progress rings showing utilization for both the 5-hour and 7-day rate limit windows
- Ultra plan support - Accounts with no 5-hour limit (verified Ultra, formerly Max 20x) are tracked on their weekly window: menu bar, gauge, projections, alerts and history all follow it
- Opus tracking - Separate gauge for Opus model usage when applicable
- Extra usage monitoring - Track overuse credits and monthly spending limits
- Burn rate projections - Linear regression on recent snapshots predicts when you'll hit your limit and what your utilization will be at reset
- Usage streaks & heatmap - See your daily activity patterns, current streak, and a GitHub-style contribution heatmap
- 7-day usage chart - Area chart showing your daily usage trends over the past week
- Multi-account support - Manage up to 5 Claude accounts and switch between them, with per-account history
- Color themes - Choose between a default claude theme and a classic multi-color theme
- Configurable notifications - Get alerted at 80%, 90%, and 95% thresholds (customizable)
- Session detection - Integrates with Claude Code hooks to detect active coding sessions and poll more frequently
- Auto-updates - Built-in Sparkle updater checks for new versions automatically
- Menu bar display modes - Show percentage + time, percentage only, time only, or just an icon
- Weekly usage in days -…
Read the full README on GitHub

Details

Language
Swift
Last updated
3 November 2026

FAQ

What is Battery?

A macOS menu bar app that monitors your Claude Code API usage in real time. It is a usage for Claude Code, from allthingsclaude/battery on GitHub.

How do I install Battery?

Run brew install --cask claude-battery, then follow the setup in the README.

Is Battery popular?

allthingsclaude/battery has 26 GitHub stars and 4 forks. It was last updated on 3 November 2026.

More usage & cost trackers

Browse the most popular Claude Code mods, all usage & cost trackers, or the skills and MCP server directories.