Token Weather

See how full Claude Code's context window is

·

source at 569c528

·

Apache-2.0 license

A one-line forecast above the prompt shows how full the context window is, as a weather icon, a percentage, tokens used out of the window and a chart of recent turns.

What this mod can do

  • Reviewed at commit 569c528
Good to know (3)
  • It measures the full window, so it can read lower than Claude Code's notice, which counts to auto-compact.
  • Updates once per turn, not during one, and reads 0% until the first response reports usage.
  • Another plugin that draws above the prompt competes for the same band.
Are mods safe?

Preview

Terminal

☀ Clear 22% of context 44k / 200k last turns ██ steady [-]

Claude Desktop

Token Weather in Claude Desktop

What it does

In the author's words

A live forecast of the context window, drawn above the prompt: a weather icon, the fill percentage, and a chart of the last turns.

What you see
A one-line weather band above the prompt
Works in
Terminal and Claude Desktop
Slash commands
None
Uses your tokens
No
Changes files
Nothing
Network access
None
Reviewed commit
569c528
Preview recorded with
Claude Code 2.1.309

How it works

  1. Takes a first reading when the session starts
  2. After each main-loop turn, reads context tokens and window size (subagent turns skipped)
  3. Picks a forecast from the share used, from ☀ Clear under 25% to ↯ Compact soon at 90%
  4. Draws the band with a chart of the last 12 turns and what the last turn added

Common questions

How do I check how much of the context window Claude Code has used?

Token Weather shows it above the prompt after every turn: the percentage used, the tokens used out of the window and a weather word for the level. It reads the same figures the status line gets (total_input_tokens, context_window_size, used_percentage).

Why is its percentage different from Claude Code's context notice?

The band measures against the full context window, while Claude Code's notice counts toward the auto-compact point, which is lower. In the author's test the band read 81% when the notice read 90%.

What do the weather icons mean?

☀ Clear under 25% used, ☁ Cloudy from 25%, ☂ Showers from 50%, ☇ Storm from 75% and ↯ Compact soon from 90%.

Badge for your README

Own this listing? Add it to your README. The badge shows the install count as it grows.

Reviewed on statuslin.es
[![Reviewed on statuslin.es](https://staging.statuslin.es/badge/mods/token-weather.svg)](https://staging.statuslin.es/mods/token-weather?utm_source=readme-badge)

Or show the preview card:

Preview on statuslin.es
[![Preview on statuslin.es](https://staging.statuslin.es/og/mods/token-weather.png)](https://staging.statuslin.es/mods/token-weather?utm_source=readme-badge)

More like this

Context Bar in Claude Desktop

Your context window as a stacked bar above the prompt, a color per category, with token counts and the compaction point. /context-bar shows or hides it.

⎿ cache-tax: keepwarm on for 6h00m, a ping 50m after each idle stretch keeps the cache read, not re-written ⎿ cache-tax: claude-opus-5-5 state warm, 1h00m left context 44,000 tokens cold cost $0.35 to re-write it (warm turn $0.01) keepwarm on, 6h00m left · ping in 50m break-even up to 40 pings at the read rate cost one cold write, about 33h20m of idle at one ping per 50m guard ask first (/cache-tax guard warn to only show the price) session 0 cold writes paid, $0.00 [>] cache-tax · warm · keepwarm 6h00m left · ping in 50m [-]

A Claude Code mod that keeps the one-hour prompt cache warm during breaks and asks before a cold send, showing its estimated rewrite cost. Warming uses model requests and costs tokens. Requires Claude Code 2.1.287+.

⎿ context-inspector: Context Inspector pane opened (shown in the terminal and the desktop app). ╭────────────────────────────────────────────────────────────────────────────────────────────────✕─╮ │ Context Inspector — main context │ │ Live ≈3.0k tokens in 12 items · 1 turn(s) · 0 compaction(s) · waste ≈0 │ │ ≈ = estimate (chars/4 × k=1.00, 0 calibration segment(s)); figures without ≈ are measured or en… │ │ │ │ Top occupants (live, by category) │ │ attachment:skill_listing ≈1.5k 50% █████░░░░░ 1 item(s) │ │ attachment:agent_listing_de… ≈685 23% ██░░░░░░░░ 1 item(s) │ │ attachment:environment ≈180 6% █░░░░░░░░░ 1 item(s) │ ╰──────────────────────────────────────────────────────────────────────────────────────────────────╯ ⚠ context-inspector: ctx 22% · waste≈0

Context waste analyzer for Claude Code: what fills the window, re-reads, near-duplicate outputs, what compaction kept, advice

Context Meter in Claude Desktop

The session's context window fill, right above the prompt: gray while there is room, yellow when it is time to /compact, red when a new session is better.

Opus 4.8 ▓▓░░░░░░░░ 22%

Model plus a 10-block context-usage bar. Example statusline inspired by the Claude Code docs (code.claude.com/docs/en/statusline).

Opus 4.8 high ✦ │ ctx 22% │ app (main) │ PR #1287 ● │ $0.41 · 10m +128 -34 Session ● ● ● ● ● ● ● ● ○ ○ ○ 74% left Resets in 2h 6m Weekly ● ● ● ● ● ● ● ● ● ● ○ 93% left Resets in 2d 0h

Feature-rich bash status line with model, context bar, session cost (read live from Claude Code, so it stays correct on any model), rate-limit bars, and live tool/agent activity that adapts to terminal width. Source: github.com/JungHoonGhae/claude-statusline

✧ ███████████▋ 73% 🗝 Ultima Weapon ✦ app ∙ main ♥ ████████████████████████ 100% 「SAVE POINT」 ✶ Limit Form ◉ 41

Claude Code plan-usage HP bar that reads the Claude auth token to show remaining usage.

Opus 4.8 │ main │ app │ ▓▓░░░░░░░░ 44k/200k │ $0.41

Catppuccin Frappé–themed status line with model, git branch and dirty flag, folder, a block context bar, and session cost. Source: github.com/danjdewhurst/cc-status-line