Skip to content

Repository files navigation

HowMuchLeft

howmuchleft is the fastest Claude Code statusline: context window, 5-hour, and weekly limit usage as three customizable gradient bars, rendering in about 6 ms. It is for Pro, Max and Team subscribers who want to see how much of every limit is left without leaving the terminal. Usage comes from the credentials Claude Code has already stored, so there is no API key to supply and no separate login.

Dark mode demo

Light mode demo

What each bar tracks:

Bar What it tracks
Context window How full your conversation is, plus subscription tier and model
5-hour usage Rolling rate limit, time until reset, git branch and the session's line counts
Weekly usage Rolling 7-day rate limit, time until reset, current directory

Works with Pro, Max 5x, Max 20x, and Team subscriptions. API key users see context bar only.

Install

go install github.com/smm-h/howmuchleft@latest

Pre-built binaries for all platforms are available on GitHub Releases.

Setup

howmuchleft profile install

This registers the binary with Claude Code's settings.json.

Uninstall

howmuchleft profile uninstall

Config

Config lives at ~/.config/howmuchleft/config.toml, auto-created on first run.

Commands

Command Purpose
howmuchleft profile install Register with Claude Code
howmuchleft profile uninstall Remove from Claude Code
howmuchleft profile list [--live] Multi-profile dashboard
howmuchleft demo Animated demo of all bars
howmuchleft colors Preview current gradient
howmuchleft config Show config path and values
howmuchleft version Print version

Performance

Claude Code spawns the statusline on every render, so start-up cost is paid every time. Medians of 100 warm runs per tool on one machine, every tool fed the same status object:

Tool Language Median ms
howmuchleft Go 5.9
cship Rust 8.3
CCometixLine (ccline) Rust 15.0
best-claude-hud Rust 15.3
claude-code-statusline-pro Rust 19.7
claude-powerline TypeScript on Node 194.5

Spawning /bin/true on the same machine medians 2.8 ms, so a good part of every compiled tool's number is the cost of starting a process at all. The full table, what each tool shows, the caveats and the harness that produced the numbers are in Comparison with other statuslines.

License

MIT

About

The fastest Claude Code statusline: context window, 5-hour, and weekly limit usage as three customizable gradient bars, rendering in about 12 ms

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages