A little more context for Claude Code

Your session,
in plain sight.

Context, growth, quota and cache warmth, right above the prompt. Open /ccoverhead when you want the details.

v1.5.7 · Release notesAvailable in Anthropic DirectoryFree · MIT · No telemetry

Rendered from the mod · Fictional figures
The desktop band: context 27%, recent growth, cache warm 38m, 5-hour quota 42%, weekly quota 63%
Desktop · vector graphics in the Code tabScroll the preview to read the full line
01 / Context

How full is the window?

The bar and colors follow your effective window: 320k/400k is 80%. Before a response, ~ marks Claude Code’s local estimate.

02 / Growth

What did this turn add?

Seven recent changes and the latest increase. Taller bars show larger changes; warmer colors flag heavier ones.

03 / Cache

Is the cache still warm?

warm 38m counts down to expiry. Its color warms as time passes; cold marks a cache that has lapsed.

04 / Quota

How much have you used?

The 5-hour and weekly shares used, with reset countdowns. A remembered reading stays dim until the session gets its own.

Behind the band

A closer look,
one command away.

Type /ccoverhead for the figures the band has no room for. The pane opens without adding a message to your conversation.

What fills the window
Local token counts by category, with the largest MCP tool schemas broken out by server.
Room before compaction
The auto-compaction threshold, tokens to go, growth since the last compaction and the last three before-and-after sizes.
Cache and quota, in detail
Cache hit rate and token counts. Every quota window, with a compact window-average exhaustion estimate when useful, plus native session cost.
The subagent view
The eight most recently observed subagents: short task description, agent ID, model, requested effort when available, last input and observed input/output tokens.
Surfaces & verification
The detail pane with context, tokens to auto-compaction, category and MCP breakdown, growth and compactions, cache hit rate, quota timing and an Explore subagent
Terminal pane · Fictional figures · Open image to inspect

As the session changes

The small details matter.

The band follows what you are looking at,
and remembers where the session left off.

A cache rewrite

A close-up of the cache group: cache warm 38m and rewrote 41k

See the rewrite, not just the warmth.

When a turn reads less than half of the previous input from cache, rewrote shows the tokens written again. The first request after compaction builds a fresh prefix and does not count as a rewrite.

A subagent’s transcript

A close-up of the agent group: a subagent's 124k context, recent growth and 12% usage

The context follows the agent.

Open a subagent’s transcript and ctx becomes agent. Its context and growth take the first group; cache and quota keep their main-conversation and account meanings.

On resume. Warmth is aged from the transcript’s last response, so a pause carries through to the cache state.

On a narrow window. Last-turn cost yields first, then all cost, then agents and the other groups from right to left. Context and its growth chart stay longest.

These previews use fictional data. The latest states have test and render coverage; live visual checks are still pending. Read the verification notes.

A consistent visual language

Cool when there’s room.
Warm when it matters.

One ten-step scale for context, quota, cache age and growth. The numbers stay readable without relying on color alone.

Room to workKeep an eye on itApproaching the limit

Percentages start at sky blue, then move a tier every ten percentage points from 30%. Cache warmth uses the share of its lifetime gone.

Growth uses thresholds that double from 0.1% of the window. A large change stands out even while the whole context is still small.

Layout, narrowing and state rules, drawn out.

Read the design rationale

Get started · two ways to install

Find ccOverhead.
Back to your work.

Install directly from the official Anthropic Directory. In Claude desktop, open Settings → Plugins → Discover, search ccOverhead, and install the entry from Anthropic Directory. No marketplace setup or terminal commands needed.

Open the directory listing

Or add our GitHub marketplace with the commands alongside. Choose one source and enable only one copy.

Requires Claude Code 2.1.288 or later.
Checked versions & surfaces

Alternative: our GitHub marketplace

Skip these commands when installing from Anthropic Directory. For this alternative, run them inside Claude Code.

  1. 01

    Add the marketplace

    /plugin marketplace add shengyy/ccoverhead
  2. 02

    Install ccOverhead

    /plugin install ccoverhead@ccoverhead
  3. 03

    Reload the plugins

    /reload-plugins
Updating or uninstalling

Installed from Anthropic Directory? Use the plugin’s details in Claude to update or remove it.

Installed from our GitHub marketplace? Refresh it, then update the plugin:

/plugin marketplace update ccoverhead
/plugin update ccoverhead@ccoverhead

To uninstall:

/plugin uninstall ccoverhead@ccoverhead

A few useful answers

Before you install.

Does the mod send data or use model tokens?

No. It reads figures Claude Code already reports, without network or model requests, file access, or background processes. Session figures stay in memory; only the last quota reading is saved in Claude Code’s plugin store. Privacy details.

Where do the band and the pane appear?

The band appears in the terminal and the Claude desktop app’s Code tab. The /ccoverhead pane targets every Claude Code surface, including VS Code and mobile. The latest pane and band additions have test and render coverage; live visual checks are pending. Verified surfaces and versions.

Why does the context sometimes have a ~?

Before the first response, after /clear, or after compaction, ~ marks Claude Code’s local estimate. The next response replaces it with a reported total. If an estimate is unavailable, the band shows -- instead of an old reading.

What about model-specific quota or gateway limits?

When Claude Code reports a weekly window for the main model, the weekly group follows it, for example 7d fable. A gateway’s spend_limit appears as spend and can exceed 100%. Both paths are covered by synthetic tests and have not yet been verified with live readings. Without them, the regular weekly window stays in use.

Are quota and cache readings cost estimates?

Quota is a share used. The pane can estimate exhaustion at the window-average pace, marked as approximate. Cost is Claude Code’s API-price reference, not a subscription invoice. Cache warmth reflects the main conversation’s reported reads and writes; ccOverhead never pauses, compacts or changes a model for you.

Does it work with a light theme?

Text and desktop graphics have matching dark and light palettes. These are covered by offline tests and fictional previews; light themes have not been verified live. Current verification limits.