claude-code-mods

token-weather

A live forecast of the context window, with a prompt-cache countdown, drawn above the prompt.

See what's happening Version 0.2.0

Lines stacked above the prompt: browser-lanes, token-weather at Cloudy 44% of context with a sparkline of the last turns, and where-am-i with the goal, now, next and waiting on you
browser-lanes, token-weather and where-am-i stacked above the prompt.

Install

claude plugin marketplace add hamzafer/claude-code-mods
claude plugin install token-weather@claude-code-mods

Restart Claude Code after installing. To try it without installing, clone the repo and run claude --plugin-dir mods/token-weather.

How to use

cacheTtl
Set to 5m or 1h to override the cache lifetime (default auto). Change it in /config

How it behaves

  • Levels go by percent of the window, so a 1M window stays Clear until 250k tokens.
  • ❄ cache 4:15 estimates how long the prompt cache stays warm. It counts down from the end of the last model request, and every request restarts it.
  • Send a prompt before it hits zero and the cached prefix is reused, billed at the cache-read rate.
  • The countdown is an estimate from timing, not read from the API. A model switch or /compact starts a fresh cache.
  • Plain while more than a minute is left, yellow under a minute, and cache cold in dim red at zero.