Token Weather: Claude Code Kontextfenster Vorhersage über dem Prompt

Token Weather ist eine Community-Mod von Hamza Zafar (hamzafer) und Teil seiner Sammlung claude-code-mods. Sie liefert eine Claude Code Kontextfenster Vorhersage in einer Zeile über dem Prompt: ein Wetterwort samt Symbol dafür, wie voll das Fenster ist, dazu die Prozentzahl, die Tokenzahl im Verhältnis zur Fenstergröße, eine Sparkline der letzten Turns und ein Countdown, wie lange der Prompt Cache noch warm bleibt.

Die Vorhersage reicht von ☀ Clear (unter 25 %) über ☁ Cloudy, ☂ Showers und ☇ Storm bis zu ↯ Compact soon ab 90 %. Daneben zeichnet last turns bis zu 12 Messwerte als ▁▂▃▄▅▆▇█, skaliert auf den größten davon, gefolgt von der Veränderung des letzten Turns, etwa ▲ +39.4k last turn. Ist die Zeile breit genug, zählt ❄ cache 4:12 bis zum Ablauf des Prompt Cache herunter, wird in der letzten Minute gelb und zeigt danach ❄ cache cold.

Token Weather überschneidet sich mit unseren Seiten zu Context Bar, Context Meter und Cache Clock. Context Bar schlüsselt das Fenster nach Kategorien auf, Context Meter zeigt Prozentwert und Tarifverbrauch in der Statuszeile, Cache Clock zeigt Cache-Details unter der Statuszeile. Token Weather liefert ein Urteil in einer Zeile und den Trend. Im Marketplace des Autors steht die Version 0.2.2.

Die Aufnahme startet Claude Code mit geladener Mod im kleinen Demoprojekt. Vor dem ersten Prompt lautet die Zeile über dem Eingabefeld ☀ Clear 0% of context 0 / 1M. Dann bitten wir Claude, README.md zu lesen und in einem Satz zu sagen, worum es im Projekt geht. Während die erste Anfrage läuft, erscheint ein Countdown ❄ cache 5:00. Nach dem Turn zeigt die Zeile ☀ Clear 4% of context 39.4k / 1M, eine Sparkline, ▲ +39.4k last turn und ❄ cache 60:00, weil die Antwort einen einstündigen Cache geschrieben hat.

Nutze eine der Methoden im Installationsblock; sie installieren direkt aus dem Marketplace des Autors. Die Zeile erscheint beim nächsten Sitzungsstart. Das Plugin hat eine einzige Option: die Lebensdauer des Prompt Cache.

Die Mod hält ihre Messwerte in $.state-Atomen, die der Host verwaltet, sodass sie einen Hot Reload überstehen. Ein Messwert wird beim Sitzungsstart und nach jedem Turn des Hauptagenten aus den Kontextwerten von $.session.usage genommen. Die Cache-Uhr startet nach jeder Modellanfrage des Hauptthreads neu, auch bei Anfragen der Tool-Schleife innerhalb eines Turns. Das ist der turn.step-Handler aus hooks/register.tsx:

on('turn.step', async function* ($, e, next) {
  const result = yield* next(e)
  if (!e.agentId && result.stopReason !== null) {
    const now = await $.clock.now()
    await update($, lastRequestAt, () => now)
    restart($, now, now, await ttlMsFor($, override))
  }
  return result
})

Im Modus auto liest sie nach jedem Turn das letzte Megabyte des Sitzungsprotokolls (<config dir>/projects/<project>/<session id>.jsonl) und sucht in cache_creation der letzten Hauptthread-Antwort nach 1-Stunden- oder 5-Minuten-Token. Das Ergebnis merkt sie sich im Speicher des Plugins für die nächste Sitzung. Ein Timer zeichnet die Zeile neu, wenn sich der Countdown-Text ändert: alle 30 Sekunden bei mehr als zehn Minuten Restzeit, darunter alle 15 Sekunden und in den letzten zwei Minuten jede Sekunde.

Die einzige Option ist cacheTtl in den Plugin-Einstellungen: auto (Standard), 5m oder 1h. Ein fester Wert hat Vorrang vor der Erkennung. Die Stufen der Vorhersage, der Verlauf von 12 Messwerten und die 60-Sekunden-Warnung sind Konstanten am Anfang von register.tsx. Die Mod liest außerdem eine optionale Reihenfolgedatei, <config dir>/claude-code-mods/bands.json, die festlegt, in welcher Reihenfolge mehrere Band-Mods desselben Autors über dem Prompt erscheinen.

Wir haben vor dem Ausführen jede Datei gelesen, die das Plugin ausführen kann: .claude-plugin/plugin.json, hooks/hooks.json, hooks/register.tsx, hooks/bands.ts, die Typdeklarationen und die drei Testdateien. Es gibt keine package.json, kein Installationsskript, keine Binärdatei und keinen gebündelten Code. Der gezeichnete Text entsteht aus Zahlen; in den Prompt des Modells wird nichts eingeschleust. Das Repository enthält eine MIT-LICENSE.

Was die Mod im Einzelnen tut:

• Netzwerk: keines.
• Prozesse: einer, tail -c 1048576 <Pfad des Protokolls>, nur wenn das Protokoll größer als 1 MB ist. Sonst wird die Datei direkt gelesen.
• Gelesene Dateien: dein eigenes Sitzungsprotokoll (zur Erkennung der Cache-Lebensdauer), die optionale bands.json im Claude-Konfigurationsverzeichnis und die Claude-Code-Einstellungen über $.settings.read (um zu sehen, ob die Cache-Clock-Statuszeile gesetzt ist). Zum Auffinden liest sie die Umgebungsvariablen HOME und CLAUDE_CONFIG_DIR.
• Geschriebene Dateien: keine direkt. Die erkannte Cache-Lebensdauer (5m oder 1h) speichert sie mit $.store, dem eigenen Speicher des Plugins.
• Hintergrundarbeit: ein Timer zum Neuzeichnen innerhalb von Claude Code, der mit der Sitzung endet. Kein Daemon.
• Eingriffe: keine. Sie blockiert oder verändert weder Tool-Aufrufe noch Prompts.

claude plugin validate meldete für das Plugin selbst weder Fehler noch Warnungen (der Verzeichnis-Checker merkt ein fehlendes Icon an). Die 24 Tests des Autors liefen mit Claude Code 2.1.307 durch.

Geprüft mit Claude Code 2.1.307 unter macOS (Validate, Tests und Aufnahme). Wenn die Zeile nicht erscheint:

• Du hast nach der Installation eine neue Sitzung gestartet; die Mod wird beim Sitzungsstart geladen.
• Über dem Eingabefeld ist keine Umfrage offen. Die Zeile weicht Umfragen und kommt danach zurück.
• Das Fenster ist mindestens 60 Spalten breit. In schmaleren Terminals erscheinen nur das Wetterwort, die Prozentzahl und die Tokenzahl.
• Stimmt der Countdown nicht, setze cacheTtl auf 5m oder 1h statt auf auto. Ein sehr langer Projektpfad oder ein Projekt, das während der Sitzung verschoben wurde, kann dazu führen, dass das Protokoll nicht gefunden wird; dann bleibt der zuletzt erkannte Wert.
• Nach /clear oder einer Wiederaufnahme bleibt der Countdown bis zur nächsten Anfrage ausgeblendet.