claude-usage-mod

Keep your context window, 5-hour session limit and weekly limit in view above the Claude Code prompt, with no menu to open. A little pixel crab sits beside them, doing his own thing, and gets more nervous the closer you get to a limit. He also levels up as you work, keeps your streak, and spends the coins you earn on hats.
This is an unofficial fan project, not affiliated with or endorsed by Anthropic. Claude and Claude Code are trademarks of Anthropic, and the pixel crab is fan art of their mascot.

How it looks

The crab's mood follows whichever of the three numbers is highest.

Under 50%: happy. Headphones on, tapping a foot, music notes drifting up.

50% and up: anxious. Nervously sipping coffee, with a note saying which limit is filling up.

80% and up: frantic. Watching the clock tick.

95% and up: this is fine. Coffee in hand, flames either side.

100%: asleep until the limit resets, and the note says when.

While Claude works, the crab joins in: it hops off the band onto the spinner line, with a thought bubble while Claude thinks and a little laptop while it writes or uses tools, then jumps back to the band when the turn is done. (In VS Code and the mobile app, which have no spinner a mod can draw on, it stays on the band.)

Reading the band

- ctx: how full the context window is.
- 5h and 7d: your session and weekly plan limits. The small arrow above each bar marks how far through that window you are; a bar past its arrow is using the limit faster than the clock.
- Colors: green under 50%, amber from 50%, red from 80%.
- $: what this session has cost so far.
- ↻: re-reads the figures right away.

You also get a short pop-up when a limit passes 50%, 80% or 95%.

Levels

The crab earns XP as you work and levels up. The level, a thin bar toward the next one, your…