Skip to content
claudemods

Claude Code Usage Mods: Context, Quota and Cost

Claude Code usage mods show context-window fill, 5-hour and 7-day plan usage, session cost and tool counts, so limits and compactions do not surprise you.

Top pick: Context Bar (#6 in Best Claude Code Mods, best in usage & cost)

>_ agent-usage-guard

Agent Usage Guard

Holds subagent fan-out, heavy-context prompts and retry loops before they burn through your Claude Code plan window.

  • status
  • Reads files
  • Intercepts tool calls
  • Reads your prompts
  • Changes the UI
  • Adds commands/tools
  • Stores data

tested with v2.1.310

Cache Clock running in Claude CodeFeatured

Cache Clock

A prompt-cache line under your Claude Code status line: time left while warm, hit rate, and tokens re-cached once cold.

  • status
  • Reads files
  • Writes files
  • Runs commands
  • Adds commands/tools

tested with v2.1.296

Cache Keeper running in Claude CodeFeatured

Cache Keeper

Shows if your Claude Code prompt cache is warm or cold, keeps big chats warm and asks before a costly cold send.

  • above-prompt
  • pane
  • toast
  • Reads files
  • Writes files
  • Calls the model (uses your quota)
  • Intercepts tool calls
  • Reads your prompts
  • Changes the UI
  • Adds commands/tools
  • Stores data

tested with v2.1.310

>_ cc-model-router

CC Model Router

Picks Haiku, Sonnet or Opus for each Claude Code turn from keywords in your prompt, with a cache-aware cooldown.

  • none
  • Reads files
  • Reads your prompts
  • Adds commands/tools

tested with v2.1.310

>_ cctop

cctop Dashboard Pane

A btop-style dashboard docked beside the Claude Code transcript: context, cost, rate limits, tools, agents and a coach.

  • pane
  • status
  • toast
  • Reads files
  • Writes files
  • Runs commands
  • Intercepts tool calls
  • Changes the UI
  • Adds commands/tools
  • Stores data

tested with v2.1.291

Context Meter running in Claude CodeFeatured

Context Meter

Context-window fill, 5-hour and 7-day plan usage and session cost in the status line, plus a warning near the limit.

  • status
  • toast
  • Changes the UI

tested with v2.1.310

Tool Call Counter running in Claude CodeFeatured

Tool Call Counter

Counts Claude's tool calls per turn and session, shows the count by the spinner, and adds /tally for a breakdown.

  • spinner
  • transcript
  • status
  • Intercepts tool calls
  • Changes the UI
  • Adds commands/tools

tested with v2.1.310

Compact Adviser running in Claude CodeFeatured

Compact Adviser

Suggests running /compact when your Claude Code session reaches a finished checkpoint, judged by TypeSafe's Jev model.

  • status
  • pane
  • toast
  • Reads files
  • Writes files
  • Network
  • Reads your prompts
  • Changes the UI
  • Adds commands/tools
  • Stores data

tested with v2.1.291

Context Bar running in Claude CodeFeatured

Context Bar

Your Claude Code context window as one stacked bar above the prompt, a color per category, with token counts.

  • above-prompt
  • Changes the UI
  • Adds commands/tools
  • Stores data

tested with v2.1.291

Context Inspector running in Claude CodeFeatured

Context Inspector

Shows what fills your Claude Code context, how much is re-reads and duplicates, and what compaction kept.

  • status
  • pane
  • toast
  • Writes files
  • Intercepts tool calls
  • Reads your prompts
  • Changes the UI
  • Adds commands/tools

tested with v2.1.303

>_ context-meter-midudev

Context Meter (midudev)

The context window fill as one gray, yellow or red percentage at the right end of the band above the prompt.

  • above-prompt
  • Changes the UI

tested with v2.1.310

ctx-handoff running in Claude CodeFeatured

ctx-handoff

Keeps the prompt cache warm, writes project notes from what you teach Claude, and can hand off a full context.

  • above-prompt
  • status
  • toast
  • Reads files
  • Writes files
  • Calls the model (uses your quota)
  • Intercepts tool calls
  • Reads your prompts
  • Changes the UI
  • Adds commands/tools
  • Stores data

tested with v2.1.303

>_ deck

Deck

A HUD above the Claude Code prompt: plan bars, subagent strips, context, usage-limit countdowns and a pet.

  • above-prompt
  • pane
  • Network
  • Intercepts tool calls
  • Reads your prompts
  • Changes the UI
  • Adds commands/tools
  • Stores data
  • Plays sound

tested with v2.1.310

>_ heatmap

Heatmap

A GitHub-style grid of your Claude Code time in a /heatmap pane, with streaks, peak hours and top projects.

  • pane
  • toast
  • Reads files
  • Writes files
  • Runs commands
  • Changes the UI
  • Adds commands/tools
  • Stores data

tested with v2.1.307

>_ jev-router

jev-router

Asks TypeSafe Jev which Claude model and effort fit each prompt, step and subagent, then runs the turn on that pick.

  • above-prompt
  • Network
  • Intercepts tool calls
  • Reads your prompts
  • Changes the UI
  • Adds commands/tools
  • Stores data

tested with v2.1.310

>_ limit-resume

limit-resume

Saves a checkpoint before your usage limit runs out, then asks the interrupted session to carry on after the reset.

  • above-prompt
  • Intercepts tool calls
  • Reads your prompts
  • Changes the UI
  • Adds commands/tools
  • Stores data

tested with v2.1.310

>_ openrouter-balance

OpenRouter Balance

Your OpenRouter credit above the Claude Code prompt: a balance gauge, today's spend and the model it mostly went to.

  • above-prompt
  • Reads files
  • Runs commands
  • Network
  • Changes the UI
  • Adds commands/tools
  • Stores data

tested with v2.1.310

Project Sentinel running in Claude CodeFeatured

Project Sentinel

A status band, context handoff, prompt cache tracking and permission rules for long Claude Code runs.

  • above-prompt
  • pane
  • spinner
  • status
  • toast
  • Reads files
  • Runs commands
  • Calls the model (uses your quota)
  • Intercepts tool calls
  • Reads your prompts
  • Changes the UI
  • Adds commands/tools
  • Stores data

tested with v2.1.296

>_ skins

Skins

Fifteen themes that redraw Claude Code tool rows, diffs, tables, code and Mermaid charts, plus a usage band.

  • above-prompt
  • spinner
  • transcript
  • pane
  • Reads files
  • Runs commands
  • Network
  • Intercepts tool calls
  • Reads your prompts
  • Changes the UI
  • Adds commands/tools
  • Stores data

tested with v2.1.307

>_ sub-meter

Sub Meter

Your 5-hour and weekly subscription usage at the bottom right of Claude Code, with a bar and a reset countdown.

  • status
  • Changes the UI
  • Stores data

tested with v2.1.307

>_ switchboard

Switchboard

Picks a Haiku, Sonnet or Opus model for each Claude Code subagent that names none, and shows what each one cost.

  • above-prompt
  • pane
  • Reads files
  • Network
  • Changes the UI
  • Adds commands/tools

tested with v2.1.310

>_ token-meter

Token Meter

Each turn's input, output and cache tokens plus a session total, in color at the end of the hint line under the prompt.

  • above-prompt
  • Changes the UI

tested with v2.1.307

Token Weather running in Claude CodeFeatured

Token Weather

A weather forecast for your Claude Code context window above the prompt, with recent turns and a prompt-cache countdown.

  • above-prompt
  • Reads files
  • Runs commands
  • Changes the UI
  • Stores data

tested with v2.1.307

Usage Meter running in Claude CodeFeatured

Usage Meter

Your plan's 5-hour and 7-day usage as small bars above the Claude Code prompt, with reset countdown and session cost.

  • above-prompt
  • toast
  • Changes the UI

tested with v2.1.291

Use Haiku running in Claude CodeFeatured

Use Haiku

Start a Claude Code prompt with _ and that one turn runs on Haiku, with a visible hint at every step.

  • spinner
  • transcript
  • status
  • Reads your prompts
  • Changes the UI

tested with v2.1.303

Claude Code usage mods keep the numbers that limit your session in view: how full the context window is, how much of the 5-hour and 7-day plan windows you have used, what the session has cost so far, and how many tool calls Claude made. You see a compaction or a rate limit coming instead of hitting it mid-task.

Where do Claude Code usage mods get their numbers?

The main source is $.session.usage(). It returns startedAt, context (tokens, window size and percent), rateLimits (one entry per plan window with percentUsed) and cost. Called without a breakdown it makes no request, so a mod can read it after every turn for free. Mods usually refresh on turn.complete, on session.compact, and on a slow $.clock.every timer, then write the result with $.ui.status.

session.measure fires after each turn and whenever plan usage changes, which suits mods that react to a threshold. Activity counters, such as a tool-call tally, count tool.call events and keep the totals in $.state. The mods reference describes the usage object.

What should you check before installing one?

A usage display should need very little: Changes the UI and nothing else is the norm. If a usage mod shows Network, it is sending your numbers somewhere; find out where. Calls the model on a usage mod is a red flag, since it would spend the quota it claims to track.

Check how it handles missing data. Before the first response there is no context figure yet, and on an API key there are no plan windows. A careful mod leaves those parts out rather than showing a misleading zero. Also check whether a warning toast fires once per threshold or on every refresh.

How to act on the numbers

When context passes about 80 percent, run /compact with a short note about what to keep, or /clear and start fresh with a summary. To know what to drop, the Claude Code context bar mod shows which category, such as MCP tools, memory files or messages, is taking the space. When a 5-hour window is high, move long jobs to later or to a smaller model. Usage mods do not change limits; they give you the warning early enough to choose.

FAQ

Does reading usage cost tokens?
Not when a mod calls $.session.usage() without a breakdown. It returns figures Claude Code already tracks. Asking for a breakdown sends a token-counting request.
Why does a usage mod show no 5-hour or 7-day figure?
Plan usage windows exist only for subscriptions. With an API key there are no rate-limit windows to show, so a good mod leaves them out instead of printing zero.
Is the cost figure the same as /cost?
It comes from the same session usage data that /cost totals, in US dollars. It is an estimate for the session, not your bill.