Token Weather mod
Draws a one-line 'weather forecast' of how full your context window is, above the prompt.
Last checked against the official docs: 2026-10-02
| Type | Official sample |
|---|---|
| Source | claude-code-playground · token-weather |
What it does
- After each turn the band shows an icon and word (Clear, Cloudy, Showers, Storm, Compact soon), the percentage of context used, tokens used out of the window, a small chart of the last 12 turns, and how much the last turn added.
- The figures are read from $.session.usage(), the same numbers the status line shows, so they are real rather than estimated.
- It is the smallest of the three official samples: one hooks module and one line of UI.
How to get it
- Clone anthropics/claude-code-playground and start Claude Code with --plugin-dir pointed at claude-code/mods/token-weather to try it for one session.
- To keep it, add the clone's claude-code/mods folder as a marketplace and install it from there.
What you can learn from its code
If you are writing your own mod, this one is a good example of:
- Drawing in the AbovePrompt band
- Reading context usage
- turn.complete hook
See how to create a mod to get started.
Related mods
- diff: Powers the /diff pane: your session's uncommitted changes shown file by file beside the transcript, refreshed as Claude edits.
- telemetry: Sends the analytics events that Claude Code's built-in mods record. Refuses calls from mods you install.
- Replay Theater: Adds /replay so you can step through every file edit Claude made in the last turn, one diff at a time.
- subagent-models: Shows which model and effort level each running subagent is using, right in the agents line of the terminal.