HowMuchLeft

Know exactly how much context and usage you have left, right in your Claude Code statusline.

Three progress bars with sub-cell precision that shift from green to red as you approach your limits:

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 diff stats
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

Two commands and you're done:

npm install -g howmuchleft
howmuchleft --install

Uninstall

howmuchleft --uninstall
npm uninstall -g howmuchleft

Customize

Config lives at ~/.config/howmuchleft.json (JSONC -- comments allowed). See config.example.json for all options.

• progressLength -- bar width in characters (default 12)
• colorMode -- "auto", "truecolor", or "256"
• partialBlocks -- true, false, or "auto" (default). Sub-cell fractional block characters. Auto disables on terminals with known rendering issues
• progressBarOrientation -- "horizontal" (default) or "vertical". Vertical mode renders 3 bar columns filling bottom-to-top across all 3 lines
• colors -- custom gradient stops and background colors per theme/color-depth combo

Preview your current gradient: howmuchleft --test-colors