Token Weather Usage

See Claude Code limits, cache and cost at a glance

·

source at 0fb3819

·

Apache-2.0 license

One band above the prompt with your context tokens, 5-hour and 7-day limits, the prompt cache's time left, the session cost and the subagents running.

What this mod can do

  • Reviewed at commit 0fb3819
  • Submits prompts for you, which can be sent as your own words
  • Reads environment variables
3 more things it can do
  • Remembers data between sessions
  • Lists running subagents
  • Runs on a timer
Good to know (3)
  • The GO pill sends phrases Claude wrote as your message. Read them in its answer before you click OK.
  • In the terminal the GO button shows only a count. In Claude Desktop, hover the pill to see each phrase.
  • Dollar figures use API list prices, so on a subscription they are an estimate, not a bill.
Are mods safe?

Preview

Terminal

☀ 44k │ 5h ━━╍─── 26% · 2h07 │ 7d ╍╍╍╍── 7% · 2d01h │ cache 5% · 1h00 │ ≈ $0.20 [-]

Claude Desktop

Token Weather Usage in Claude Desktop

What it does

In the author's words

One line above the prompt: context tokens with their weather, a bar per recent prompt, your 5-hour and 7-day limits against the time elapsed, the prompt cache with its time left, the session cost with the last prompt's share in dollars and in points of the 5-hour limit, the subagents running, and a one-click pill for the GOs Claude proposes. Labels in English, French or Russian. After Token Weather (Anthropic, Apache-2.0) and the ideas of usage-meter (HolyGrail) and prompt-cache-control (Daniel San).

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

How it works

  1. Starts with the session and redraws the band above the prompt as usage changes
  2. Reads Claude Code's own figures: context, limits, session cost and cache tokens
  3. After each answer, picks up quoted approvals that start with GO, such as “GO push”
  4. A click on the GO pill's OK sends those approvals back as your own message

Common questions

What does the GO pill send, and when?

When Claude's last answer quotes approvals that start with GO (in “ ”, " ", « » or backticks), a green pill shows how many. Clicking its OK sends one message as you: "You have my approval for all the GOs:" followed by each phrase in quotes. Nothing is sent without that click, and the pill clears when the next turn starts.

How do I turn off the GO pill?

Turn off the GO pill option in /config. It is on by default. The rest of the band keeps working without it.

Does it send my usage data anywhere?

No. statuslin.es found no internet access, and the README says it makes no network requests. It keeps recent readings in the plugin's local storage and deletes a session's data after 8 idle days.

How does it know when the prompt cache will expire?

It infers the cache lifetime: 1 hour on a subscription, 5 minutes on an API key. The cache pill turns yellow under 10 minutes left and red once the cache has expired, with what writing the context again would cost.

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-usage.svg)](https://staging.statuslin.es/mods/token-weather-usage?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-usage.png)](https://staging.statuslin.es/mods/token-weather-usage?utm_source=readme-badge)

More like this

Deck in Claude Desktop

A cockpit for Claude Code: plan bars and subagent strips, context, usage limits with reset countdowns and burn rates, spend, the model route and a pet. Six bar styles, three collapsed looks. CLI and Desktop.

Flightdeck in Claude Desktop

Flightdeck: a live agent dashboard for Claude Code. Main model vitals, an on-call architect, every permission check, subagent cards and swimlanes, a turn receipt and a session log, all from real session events

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

Opus 4.8 │ ✍️ 78% │ app (main) │ +128/-34 Cost $0.4100 Tokens in 44.0k │ cache write 5000 │ cache read 2000 │ out 1.4k

Compact status line showing model, context remaining %, directory/git, session time and lines changed, with rate-limit bars or a cost/token breakdown. Source: github.com/susomejias/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