ccstatusline: Statuszeilen-Formatter für Claude Code

Ein Formatter für die Statuszeile von Claude Code

ccstatusline ist ein TypeScript-Werkzeug, das die Statuszeile formatiert, die Claude Code im Terminal anzeigt. Das README stellt das Projekt als hochgradig anpassbaren Statuszeilen-Formatter vor, und die einleitende Beschreibung nennt Modellinformationen, Git-Branch, Token-Verbrauch und andere Kennzahlen. Der Schwerpunkt des Projekts liegt darauf, dass der Nutzer wählen kann, welche dieser Werte erscheinen und wie sie gestaltet sind, nicht auf einer einzigen festen Anzeige. Diese Wahl zieht sich durch fast jede Funktion: Ob es sich um den Modellnamen oder einen Block-Timer handelt, die TUI entscheidet, ob er angezeigt wird und in welchem Format. Im konkreten Projekt sollte man dabei die genannten Eingabedateien, Konfigurationswerte und Ausgaben gemeinsam betrachten. So lässt sich erkennen, ob das beschriebene Verhalten unter den eigenen Bedingungen eintritt und welche Grenzen die README offenlässt. Im konkreten Projekt sollte man dabei die genannten Eingabedateien, Konfigurationswerte und Ausgaben gemeinsam betrachten. So lässt sich erkennen, ob das beschriebene Verhalten unter den eigenen Bedingungen eintritt und welche Grenzen die README offenlässt.

TUI ohne globale Installation ausführen

Im Abschnitt Schnellstart heißt es, eine Installation sei nicht nötig: `npx -y ccstatusline@latest` oder `bunx -y ccstatusline@latest` öffnet die Konfigurations-TUI, und das README stellt fest, dass beide Befehle dieselbe TUI starten. Im anfänglichen Einrichtungsablauf kann der Nutzer eine fest installierte globale Installation (Pinned global install) wählen. Dabei wird die laufende Version mit npm oder Bun global installiert und `"command": "ccstatusline"` in die Claude-Code-Einstellungen geschrieben, sodass die CLI auf dieser Version bleibt und nicht `@latest` folgt. Danach öffnet der direkte Aufruf von `ccstatusline` die TUI. In den Versionshinweisen des README heißt es, dass beim Deinstallieren die vorhandenen Einstellungen erhalten bleiben. Im konkreten Projekt sollte man dabei die genannten Eingabedateien, Konfigurationswerte und Ausgaben gemeinsam betrachten. So lässt sich erkennen, ob das beschriebene Verhalten unter den eigenen Bedingungen eintritt und welche Grenzen die README offenlässt. Im konkreten Projekt sollte man dabei die genannten Eingabedateien, Konfigurationswerte und Ausgaben gemeinsam betrachten. So lässt sich erkennen, ob das beschriebene Verhalten unter den eigenen Bedingungen eintritt und welche Grenzen die README offenlässt.

Was die Konfigurations-TUI übernimmt

Die TUI deckt Layout und Darstellung ab: mehrere unabhängige Statuszeilen, Hinzufügen, Entfernen und Sortieren von Widgets, Farben pro Widget, Verhalten der Flex-Trenner, benutzerdefinierte Text-Widgets und eine Echtzeit-Vorschau. Sie installiert oder deinstalliert die Statuszeile auch in den Claude-Code-Einstellungen und kann das Aktualisierungsintervall setzen; laut README wird refreshInterval nur geschrieben, wenn Claude Code Version 2.1.97 oder neuer ist. Der Widget-Auswähler unterstützt das Durchsuchen nach Kategorie, Suche und Rangfolge-Abgleich; das README nennt ihn einen schnellen Widget-Auswähler, ohne konkrete Leistungszahlen zu nennen. In den Danksagungen werden React und Ink für die Terminal-Oberfläche genannt. Die Einstellungen werden unter `~/.config/ccstatusline/settings.json` gespeichert. Im konkreten Projekt sollte man dabei die genannten Eingabedateien, Konfigurationswerte und Ausgaben gemeinsam betrachten. So lässt sich erkennen, ob das beschriebene Verhalten unter den eigenen Bedingungen eintritt und welche Grenzen die README offenlässt. Im konkreten Projekt sollte man dabei die genannten Eingabedateien, Konfigurationswerte und Ausgaben gemeinsam betrachten. So lässt sich erkennen, ob das beschriebene Verhalten unter den eigenen Bedingungen eintritt und welche Grenzen die README offenlässt.

Widgets für Git, Verbrauch, Kontext und Timer

In den Versionshinweisen werden Widgets für Git-Branch und PR/MR-Status, für gestaffelte, nicht gestaffelte und unverfolgte Dateizahlen, für Einfügungen und Löschungen, für Sitzungs- und Wochenverbrauch, für den Wochenverbrauch von Sonnet, Opus und Fable, für Überschreitungsgrenzen des Zusatzverbrauchs, für Cache-Trefferquote sowie Lese- und Schreibvorgänge des Prompt-Cache, für Kontextlänge und Kontextfenster, für den Kompaktierungszähler, für Block- und Rücksetztimer, für Speichernutzung, Token-Geschwindigkeit, Sprachstatus, Vim-Modus, Denkstufe, Sitzungsname und -kosten, für das aktuelle Arbeitsverzeichnis und für benutzerdefinierten Text aufgezählt. Es gibt auch Status-Widgets für Git-Konflikte, SHA, Upstream- und Origin-Repositorys sowie für den Worktree-Modus. Viele dieser Widgets haben Umschalter für Verbergen bei leerem Inhalt, kurze Fortschrittsbalken und Rohwert-Modus. Das README bietet keine vollständige Widget-Liste für die aktuelle Version; die Versionshinweise sind das Inventar. Im konkreten Projekt sollte man dabei die genannten Eingabedateien, Konfigurationswerte und Ausgaben gemeinsam betrachten. So lässt sich erkennen, ob das beschriebene Verhalten unter den eigenen Bedingungen eintritt und welche Grenzen die README offenlässt. Im konkreten Projekt sollte man dabei die genannten Eingabedateien, Konfigurationswerte und Ausgaben gemeinsam betrachten. So lässt sich erkennen, ob das beschriebene Verhalten unter den eigenen Bedingungen eintritt und welche Grenzen die README offenlässt.

Neuere Releases konzentrieren sich auf Aktualisierungszuverlässigkeit und Cache

Releases ab v2.2.27 befassen sich wiederholt mit demselben Problem: Statusaktualisierungen sollen nicht blockieren. Git-PR/CI-Widgets rendern aus einem versionierten Festplatten-Cache, während veraltete Daten im Hintergrund aktualisiert werden. Git-Helfer übergeben `--no-optional-locks`, um `index.lock`-Konflikte zu vermeiden, und Git-Ausgaben werden unter `~/.cache/ccstatusline/git-cache` zwischengespeichert, mit mtime-Prüfungen auf `.git/HEAD` und `.git/index`. Weitere Einträge betreffen Kontext-Rücksetzungen nach `/compact`, Rückfälle, wenn die Verbrauchs-API ihre Antwortstruktur ändert, und die Behandlung ungültiger `settings.json`-Dateien, die unangetastet bleiben, während Standardwerte im Speicher gerendert werden. Keiner dieser Einträge enthält Benchmark-Daten, und das README behauptet keine bestimmte Geschwindigkeitsverbesserung; es beschreibt die Änderungen als Korrekturen und Absicherungen. Im konkreten Projekt sollte man dabei die genannten Eingabedateien, Konfigurationswerte und Ausgaben gemeinsam betrachten. So lässt sich erkennen, ob das beschriebene Verhalten unter den eigenen Bedingungen eintritt und welche Grenzen die README offenlässt. Im konkreten Projekt sollte man dabei die genannten Eingabedateien, Konfigurationswerte und Ausgaben gemeinsam betrachten. So lässt sich erkennen, ob das beschriebene Verhalten unter den eigenen Bedingungen eintritt und welche Grenzen die README offenlässt.

Umgebungsvariablen und Plattformhinweise

Dokumentierte Umgebungsvariablen sind `CLAUDE_CONFIG_DIR` für nicht standardmäßige Claude-Code-Konfigurationsorte, `HTTPS_PROXY` für Verbrauchs-Widgets, die die Anthropic-API direkt aufrufen, `CCSTATUSLINE_WIDTH` für eine explizite Terminalbreite und `CCSTATUSLINE_CONTEXT_SIZE_FALLBACK` für das standardmäßige 200k-Kontextfenster, wenn weder Claude Code noch der Modellname eines meldet. Windows-Hinweise, PowerShell-Beispiele, Schriftarten, WSL und Windows-Terminal-Konfiguration stehen in `docs/WINDOWS.md`. Das README dokumentiert keine weiteren Proxy-Variablen und nennt keine Laufzeitunterstützung über Bun, Node.js und die Windows-Hinweise hinaus. Im konkreten Projekt sollte man dabei die genannten Eingabedateien, Konfigurationswerte und Ausgaben gemeinsam betrachten. So lässt sich erkennen, ob das beschriebene Verhalten unter den eigenen Bedingungen eintritt und welche Grenzen die README offenlässt. Im konkreten Projekt sollte man dabei die genannten Eingabedateien, Konfigurationswerte und Ausgaben gemeinsam betrachten. So lässt sich erkennen, ob das beschriebene Verhalten unter den eigenen Bedingungen eintritt und welche Grenzen die README offenlässt.

Lizenz, Autor und verwandte Projekte

ccstatusline ist MIT-lizenziert, Copyright 2025 Matthew Breedlove, der das Projekt unter dem Handle sirmalloc pflegt. Der MIT-Text erlaubt Verwendung, Kopie, Änderung, Zusammenführung, Veröffentlichung, Verbreitung, Unterlizenzierung und Verkauf und schließt jede Gewährleistung aus; zu Support, Sicherheitszusagen oder Wartungsverpflichtungen sagt er nichts. Das README listet verwandte Projekte, darunter einen visuellen Konfigurationseditor, Verbrauchs-Tracker und andere Statuszeilen-Werkzeuge, und weist darauf hin, dass die chinesische Lokalisierung ein Dritt-Fork ist, der außerhalb dieses Repositories gepflegt und von ihm weder geprüft noch unterstützt wird. Die Beitragsanleitung beschreibt einen Ablauf aus Fork, Branch, Commit, Push und Pull-Request und begrüßt Beiträge. Im konkreten Projekt sollte man dabei die genannten Eingabedateien, Konfigurationswerte und Ausgaben gemeinsam betrachten. So lässt sich erkennen, ob das beschriebene Verhalten unter den eigenen Bedingungen eintritt und welche Grenzen die README offenlässt. Im konkreten Projekt sollte man dabei die genannten Eingabedateien, Konfigurationswerte und Ausgaben gemeinsam betrachten. So lässt sich erkennen, ob das beschriebene Verhalten unter den eigenen Bedingungen eintritt und welche Grenzen die README offenlässt.

Redaktionelles Fazit

Der Wert von ccstatusline liegt in der Breite der konfigurierbaren Widgets und in der TUI, die sie bearbeitet; die Versionshistorie zeigt, dass die Releases vor allem Widgets hinzufügen und die Zuverlässigkeit der Aktualisierung verbessern. Das Projekt ist MIT-lizenziert, und unter den im README genannten verwandten Projekten ist die chinesische Lokalisierung ein Dritt-Fork außerhalb dieses Repositories.

Offizielle Quellen

1. Official README
2. Project repository
3. Release notes