Maxx

Maxx is a status line utility that tracks your Claude Code token consumption in real time. It displays a fuel gauge style readout directly in your terminal, showing how much of your session and weekly limits you have used. The goal is to help you pace your usage so you do not burn through your allocation early in the week and end up throttled when you need it most.

Claude Code enforces two caps, a five hour session limit and a seven day weekly limit. Maxx calculates a sustainable spending rate by dividing your remaining weekly tokens by the number of five hour windows left until the reset. It then compares your actual pace against that budget and shows whether you are banking tokens or overspending. Two visual rails in the status line give you a quick read. The session rail shows your current window, green if you are under budget and red if you are burning hot. The weekly rail acts like a fuel tank indicator, changing color as you approach depletion.

The calculations pull from Anthropic's official usage endpoint, so the numbers stay accurate. Maxx also factors in per model price weighting, since Opus, Sonnet, Haiku, and Fable consume tokens at different rates. A cache hit rate display helps you understand how much of your traffic is being served from cache versus fresh inference. All of this runs locally with no data leaving your machine.

Installation is a single curl command that downloads and sets up everything. You can also clone the repository and configure manually if you prefer. The tool works across macOS and Linux terminals, including Terminal.app, iTerm2, Ghostty, Warp, Alacritty, and kitty. A slash command, /maxx, gives you a quick summary without checking the status line. The display uses plain ANSI formatting with animated digit updates when numbers change.

Maxx is open source under the MIT license. The repository is on GitHub, and the maintainer Reif is reachable at reif@thegoodproject.net. There is no paid tier or premium version. It is a utility for power users of Claude Code who want visibility into their consumption patterns without switching to a dashboard or checking manually.

The audience is developers who rely on Claude Code for serious work and want to avoid hitting limits unexpectedly. If you have ever been surprised by a throttle mid session, Maxx gives you the awareness to spread your usage more evenly across the week.