Context Bar: Der Claude Code Kontextfenster-Balken zeigt, was den Kontext füllt

Context Bar ist eine Community-Mod von Hamza Zafar (hamzafer) aus seiner Sammlung claude-code-mods. Der Claude Code Kontextfenster-Balken beantwortet eine Frage: Was füllt mein Kontextfenster? Über dem Prompt von Claude Code zeichnet die Mod ein kleines umrandetes Band mit einem einzigen gestapelten Balken in Terminalbreite. Der Balken ist in dieselben Kategorien aufgeteilt, die /context verwendet, etwa System-Prompt, Tools, MCP-Tools, Memory-Dateien, Skills und Nachrichten, gefolgt von freiem Platz und dem Auto-Compact-Puffer.

Die Kopfzeile lautet zum Beispiel 48k of 200k · compacts at 167k und trägt ein farbiges Prozent-Badge. Das Badge ist grün, wird bei 70 % des Komprimierungspunkts gelb und bei 90 % rot (gemessen am vollen Fenster, wenn Auto-Compact aus ist). Unter dem Balken listet eine Legende jede Kategorie mit ihrer Token-Zahl und ihrem Anteil am Fenster, verteilt auf so viele Zeilen, wie die Terminalbreite verlangt. Tool-Schemas, die erst bei Bedarf geladen werden, bleiben außen vor, so wie /context sie aus seinem Raster weglässt.

Context Bar ähnelt unserem eigenen Kontext-Meter, zeigt aber anderes. Das Kontext-Meter ist ein einzelner Text in der Statuszeile mit dem gesamten Kontext-Prozentwert, den 5-Stunden- und 7-Tage-Planfenstern, den Sitzungskosten und einer einmaligen Warnung bei 80 %. Context Bar zeigt weder Plannutzung noch Kosten; stattdessen schlüsselt es den Kontext nach Kategorien auf, sodass du siehst, ob MCP-Tools, Memory-Dateien oder das Gespräch selbst den Platz belegen. Laut README des Autors ist Claude Code 2.1.287 oder neuer nötig.

Die Aufnahme startet Claude Code mit geladener Mod im kleinen Demo-Projekt und bittet Claude, README.md zu lesen und das Projekt in einem Satz zu beschreiben. Wenn der Turn endet, zeigt das Band über dem Prompt das Kontextfenster nach Kategorien aufgeteilt (System-Prompt, System-Tools, Skills, Nachrichten, freier Platz), die Summe wie 54k of 200k, den Punkt, an dem Auto-Compact greift, und den belegten Prozentsatz.

Nutze eine beliebige Methode aus dem Installationsblock; alle installieren direkt aus dem eigenen Marketplace des Autors. Der Balken erscheint beim nächsten Sitzungsstart, und /context-bar blendet ihn aus oder ein.

Die Mod hält den letzten Messwert in einem vom Host verwalteten $.state-Atom, sodass er einen Hot Reload übersteht, und zeichnet ihn an der Render-Stelle AbovePrompt neu. Die Aktualisierungsfunktion aus hooks/register.tsx:

// Asks the engine for /context's breakdown, estimated locally (no token-count calls).
async function refresh($: EngineInterface) {
  if (await read($, isHidden)) return
  const usage = await $.session.usage({ breakdown: 'summary' })
  const b = usage.context.breakdown
  if (!b || !(b.rawMaxTokens > 0)) return // no window to measure against
  await update($, reading, () => toReading(b))
}

refresh läuft bei session.start, bei turn.complete, wenn keine agentId gesetzt ist (Subagent-Turns werden übersprungen), und bei session.compact, denn ein /compact leert das Fenster, ohne dass ein Turn endet. toReading verwirft verzögert geladene und leere Kategorien, sortiert belegte Zeilen vor freien Platz und Puffer und vergibt die Farben. Die reinen Hilfsfunktionen cells und legend machen aus dem Messwert Balkenabschnitte und Legendenzeilen: Jede belegte Kategorie bekommt mindestens eine Zelle, und Rundungsreste gehen zuerst an den freien Platz. Unter 20 Spalten Innenbreite wird der Balken nicht gezeichnet. Belegt eine Umfrage den Platz über dem Prompt, tritt das Band zur Seite.

In /config gibt es keine Optionen. Der einzige Schalter ist der Befehl /context-bar, dessen Zustand (ausgeblendet/sichtbar) mit $.store gespeichert wird. Um das Aussehen zu ändern, bearbeite die Konstanten oben in register.tsx: PALETTE für die Kategoriefarben, MESSAGES für die Farbe der Nachrichten, GLYPH für die Balkenzeichen und MIN_WIDTH für die kleinste Breite, bei der noch gezeichnet wird.

Wir lesen jede Datei, die das Plugin ausführen kann, bevor wir es starten: hooks/hooks.json, hooks/register.tsx, die Typdeklarationen und die Tests. Es gibt keine package.json, kein Installationsskript und keinen gebündelten Code.

Ändert die UI betrifft das Band über dem Prompt. Fügt einen Befehl hinzu betrifft /context-bar. Die Mod liest Kontextwerte über $.session.usage, speichert einen einzigen Wahr/Falsch-Wert mit $.store und hält ihren Messwert in $.state. Sie führt keine Shell-Befehle aus, liest oder schreibt keine Dateien, nutzt kein Netzwerk, liest keine Umgebungsvariablen und ruft das Modell nicht auf. claude plugin validate meldete keine Fehler oder Warnungen, und die 6 Tests des Autors liefen unter Claude Code 2.1.291 durch.

Geprüft mit Claude Code 2.1.291 unter macOS (validate und Tests). Wenn der Balken nicht erscheint:

• claude --version ist 2.1.287 oder neuer.
• Du hast ihn nicht früher ausgeblendet: Führe /context-bar einmal aus und achte auf „Context bar on“.
• Das Terminal ist breit genug: Das Band braucht mindestens 24 Spalten.
• Über der Eingabe ist eine Umfrage geöffnet; das Band kehrt zurück, sobald sie geschlossen ist.
• Die Aufschlüsselung gibt es erst, wenn Claude Code die Fenstergröße kennt. Fehlt das Band ganz am Anfang, sende einen Prompt.