---
title: "token-weather-usage"
url: "https://claudemods.dev/en/builds/token-weather-usage-df7534"
source: "https://github.com/augiefra/claude-mods/tree/main/plugins/token-weather-usage"
source_type: "github"
repo: "https://github.com/augiefra/claude-mods/tree/main/plugins/token-weather-usage"
author: "augiefra"
author_handle: "augiefra"
stars: 30
category: "Usage & costs"
categories: ["cost"]
tags: ["Claude Code", "mod"]
permission_level: 1
scan_complete: true
install: "claude plugin marketplace add augiefra/claude-mods\nclaude plugin install token-weather-usage"
added: "2026-10-03T12:00:58.826Z"
updated: "2026-11-14T08:18:30Z"
locale: "en"
content_locale: "en"
---

# token-weather-usage

token-weather-usage：One line above the prompt: context weather, tokens, a bar per recent prompt, then your 5-hour and 7-day limits

## Description

# Token Weather Usage

One line above the Claude Code prompt: your 5-hour and 7-day limits against the clock, the context weather, the tokens, and a bar per prompt.

![The band in the desktop app](https://raw.githubusercontent.com/augiefra/claude-mods/main/docs/band.png)

- **5h / 7d**: the share of your account's limits already used, in green, yellow or red by pace. The gap with the time elapsed is hatched: grey while you have margin, in the bar's color when you use faster than time passes. Then the time left and the reset time (machine's time zone).
- **Context weather**: from Clear to "Compact soon", by the share of the context window in use. Icons drawn in the app, Unicode symbols in the terminal.
- **Context**: percentage and tokens used out of the window.
- **Turns**: one bar per prompt for the last 8, as tall as the tokens it added; the current prompt in color. Kept across restarts.

![Hatching of the gap with elapsed time](https://raw.githubusercontent.com/augiefra/claude-mods/main/docs/gauges-hatching.png)

In the terminal:

```
☂ Showers │ 63% context · 634k/1M │ turns ▃▆▂█▃▄▂▆ ▲ +6.3k │ 5h ━━━━━━╍─ 74% · 24 min → 18:20 │ 7d ━━━━━─── 65% · 2d20h
```

Labels in English or French: `auto` follows `LC_ALL`, `LC_MESSAGES` or `LANG`, otherwise pick `en` or `fr` in the **Language** option (`/config`).

## Privacy

No personal data collected, sent or retained, no network requests. The mod reads the usage figures Claude Code provides and the locale variables, and keeps in the plugin's local storage the latest limits reading and, per session, recent context readings (deleted after 8 idle days).

## Credits and license

Weather, context and turns chart after Anthropic's **Token Weather** example ([claude-code-playground](https://github.com/anthropics/claude-code-playground), Apache-2.0). Limit gauges written after HolyGrail's **usage-meter** ([HolyGrail/claude-mods](https://github.com/HolyGrail/claude-mods/tree/main/plugins/usage-meter)), without copying its code. Apache-2.0 license: see [LICENSE](https://github.com/augiefra/claude-mods/blob/main/LICENSE) and [NOTICE](https://github.com/augiefra/claude-mods/blob/main/NOTICE).

## Install

```
claude plugin marketplace add augiefra/claude-mods
claude plugin install token-weather-usage
```

## Original README

# Token Weather Usage

One line above the Claude Code prompt: your 5-hour and 7-day limits against the clock, the context weather, the tokens, and a bar per prompt.

![The band in the desktop app](https://raw.githubusercontent.com/augiefra/claude-mods/main/docs/band.png)

- **5h / 7d**: the share of your account's limits already used, in green, yellow or red by pace. The gap with the time elapsed is hatched: grey while you have margin, in the bar's color when you use faster than time passes. Then the time left and the reset time (machine's time zone).
- **Context weather**: from Clear to "Compact soon", by the share of the context window in use. Icons drawn in the app, Unicode symbols in the terminal.
- **Context**: percentage and tokens used out of the window.
- **Turns**: one bar per prompt for the last 8, as tall as the tokens it added; the current prompt in color. Kept across restarts.

![Hatching of the gap with elapsed time](https://raw.githubusercontent.com/augiefra/claude-mods/main/docs/gauges-hatching.png)

In the terminal:

```
☂ Showers │ 63% context · 634k/1M │ turns ▃▆▂█▃▄▂▆ ▲ +6.3k │ 5h ━━━━━━╍─ 74% · 24 min → 18:20 │ 7d ━━━━━─── 65% · 2d20h
```

Labels in English or French: `auto` follows `LC_ALL`, `LC_MESSAGES` or `LANG`, otherwise pick `en` or `fr` in the **Language** option (`/config`).

## Privacy

No personal data collected, sent or retained, no network requests. The mod reads the usage figures Claude Code provides and the locale variables, and keeps in the plugin's local storage the latest limits reading and, per session, recent context readings (deleted after 8 idle days).

## Credits and license

Weather, context and turns chart after Anthropic's **Token Weather** example ([claude-code-playground](https://github.com/anthropics/claude-code-playground), Apache-2.0). Limit gauges written after HolyGrail's **usage-meter** ([HolyGrail/claude-mods](https://github.com/HolyGrail/claude-mods/tree/main/plugins/usage-meter)), without copying its code. Apache-2.0 license: see [LICENSE](https://github.com/augiefra/claude-mods/blob/main/LICENSE) and [NOTICE](https://github.com/augiefra/claude-mods/blob/main/NOTICE).
