Claude Code mod · v1.0.0 · free and MIT

Your limits,always in view.

A pixel crab lives above your Claude Code prompt, beside your context window, 5-hour limit and weekly limit. He gets nervous as they fill, levels up while you work, and spends the coins you earn on hats.

Install the mod

He jumped down into the band. Scroll up and he jumps back.

WebGL·—voxels from the mod's own pixel art

The real band, running in your browser

01Try itLive renderer

Send a prompt.
Watch the band.

This window runs the mod's real drawing and game code. Type anything and press Enter. The crab thinks, then writes, and every reply moves the bars and earns XP. Drag the window's right edge to watch the band fit any width.

Claude Code · ~/my-app

Ask for anything. Nothing leaves this page; the replies are canned.

— px wide

02MoodsScroll-scrubbed

One crab, five moods.

Under 50%

Vibing.

Headphones on, tapping a foot, music notes drifting up.

  1. 0%Happy
  2. 50%Anxious
  3. 80%Frantic
  4. 95%This is fine
  5. 100%Asleep

03LevelsSide-scroller

He levels up as you work.

TitleHatchling

03Where XP comes from

    Level curve

    Level L needs 50 × L × (L − 1) XP

    Each level costs 100 XP more than the last. Daily use reaches level 10 in about a week and level 50 in about seven months.

    Each day with a turn adds one to your streak. Every seven days earns a rest day, up to two, which covers a day off.

    Thirteen badges to find.

    Each one is worth 50 XP and 25 coins.

    04ShopWebGL fitting room

    Tokens become hats.

    Every 1,000 tokens Claude writes earns a coin, plus 100 for each level and 25 for each badge. Spend them on 30 things for the crab across seven slots. Hover to try something on, then click to buy it with the coins you earned above. He wears it everywhere on this page.

    WearingNothing yet
    Drag to turn him
    0
    Your coins
    Lv 12

    These coins are pretend and live only on this page. In the mod, /usage-hud shop opens the same shelf as a panel, and the coins come from your real work.

    05BackdropsOrdered dither

    Six places to sit.

    On the band each backdrop sits at half strength, so the figures stay easy to read.

    Forest

    Pines on low hills, with fireflies after dark.

      06Under the hoodSystems

      Small, careful, and yours.

      Every session agrees.

      Plan limits arrive with each reply, and each session hears only its own. The mod keeps the newest reading in one small file, so every open session shows the same 5-hour and weekly figures within ten seconds.

      It updates itself, carefully.

      Every six hours the mod asks GitHub's public tag list for a newer release. Press the button and it fast-forwards its own folder to that one tag. It never moves a repository it was copied into, and never overwrites your changes.

      The terminal gets text bars.

      In the terminal the band is plain text, with a face that matches his mood. It gives things up in the same order as the desktop band when the window narrows.

      Nothing about you leaves your machine.

      Your level, coins and the last readings live in one small file under your Claude Code config, shared by every session and project. The only network call is that tag check, with no account and no token. Set CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC to turn it off.

      07Reel60 fps · motion-blurred

      Fifteen seconds of crab.

      Every frame of the reel is drawn by the mod's own art code, then rendered with eight motion-blur samples and scored to the cut.

      claude-usage-mod · motion reel1920 × 1080 · 0:15 · sound on

      08InstallTwo steps

      Clone it, point Claude Code at it.

      01Clone the repo

      Anywhere works. The update button keeps this folder current.

      git clone https://github.com/lucassimzq/claude-usage-mod.git ~/claude-usage-mod

      02Load it

      Add it to the env block of ~/.claude/settings.json. This covers the desktop app too.

      {
  "env": {
    "CLAUDE_CODE_PLUGIN_DIRS": "~/claude-usage-mod",
    "CLAUDE_CODE_PLUGIN_DIR_WATCH": "1"
  }
}

      Good to know

      • NeedsClaude Code 2.1.286 or later. The 5h and 7d bars need a Claude subscription.
      • Shows inThe terminal and the desktop app's Code tab. It doesn't show on claude.ai, where mods can't load.
      • /usage-hudHides or shows the band, and remembers your choice.
      • /usage-hud statsLevel, XP, streak, coins and badges.
      • /usage-hud shopOpens the shop as a panel you click through.
      • /usage-hud updateChecks for a new version now and installs it.