Claude Code Limits & Burn-Rate
direkt im KDE Panel.
Echtzeit-Transparenz über deine 5-Stunden- und 7-Tage-Token-Budgets. Intelligente Burn-Rate-Vorhersagen mittels linearer Regression, Soll-Pace-Vergleich und Warnungen vor dem Reset.
Echte Desktop-Aufnahmen & Themes
So fügt sich KDEClaudeStat nahtlos in dein Linux-System ein: Im hellen und dunklen Plasma-Look, im aktiven Arbeitseinsatz mit Burn-Rate-Warnung sowie mit flexiblen Einstellungsdialogen.
- 5h-Session & 7d-Wochenlimit: Exakte Prozentanzeige mit dynamischem Farbindikator (Grün, Gelb, Rot).
- Soll-Pace & ETA-Warnung: Mathematischer Abgleich, ob deine Token-Burn-Rate das Limit vor dem nächsten Reset erreicht.
- Mini Burnup-Kurve: Visueller Trendverlauf direkt im Kirigami-Popup ohne externe Tools.
- Reale Burn-Rate-Vorhersage: Berechnet die reale Token-Geschwindigkeit (z. B. 18.94%/h) und prognostiziert die Zeit bis 100%.
- Pace-Abgleich & Frühwarnung: Rote Alarmmeldung („Limit vor Reset erreicht!“), sobald der Verbrauchskorridor über der Soll-Pace liegt.
- Regressions-Trendkurve: Gestrichelte Ausgleichsgerade und farbige Trendzonen direkt im Kirigami-Diagramm.
- Farbschema / Stil: Automatische Theme-Anpassung oder feste Auswahl aus Plasma Default, Hell, Dunkel und Transparent.
- Aktualisierungsintervall: Wählbar zwischen 15s, 30s, 1 Minute, 2 Minuten oder 5 Minuten.
- Nativer KCM Dialog: Öffnet sich nahtlos über den KDE Rechtsklick → „KDEClaudeStat einrichten...“.
Minimalistische Architektur ohne Überflüssiges
KDEClaudeStat bietet maximale Transparenz bei minimalem Ressourcenverbrauch – nativ integriert in das KDE Plasma 6 Desktop-Ökosystem.
Natives KDE Plasma 6 Widget
Geschrieben in deklarativem QML & Kirigami. Unterstützt Panel-Tray-Modus sowie Desktop-Platzierung mit automatischer Theme-Anpassung (Plasma Default, Hell, Dunkel, Transparent).
Präzise Burn-Rate & Regression
Verwendet mathematische Ausgleichsrechnung (Least Squares), um die reale Verbrauchsgeschwindigkeit pro Stunde zu berechnen und das Risiko eines 100%-Limits vor dem Reset exakt vorherzusagen.
Zero Bloat & Local-First
Keine externen npm-Pakete oder schweren Daemon-Runtimes. Das Backend nutzt ausschließlich die Python 3 Standardbibliothek (http.server, sqlite3, urllib).
D-Bus On-Demand & systemd
Dank D-Bus Service-Aktivierung startet das Backend ressourcenschonend genau dann, wenn Plasma das Widget lädt. Alternativ steht ein systemd User-Service für dauerhaften Hintergrundbetrieb bereit.
Lokale SQLite History
Historische Messpunkte werden unter ~/.local/share/kde-claude-stat/history.db gespeichert – mit automatischer Zeitfenster-Deduplizierung zur Schonung von Speicher und IO.
Sichere Token-Verwaltung
Niemals Tokens im Klartext im Repo: Das Backend liest das bestehende OAuth-Token direkt aus deiner lokalen Claude Code Konfiguration (~/.claude/.credentials.json).
In wenigen Schritten einsatzbereit
Das automatisierte Installationsskript registriert das Plasmoid, richtet D-Bus & systemd ein und prüft alle Voraussetzungen.
Spezifikationen & Schnittstellen
| Komponente | Technologie | Rolle & Funktion |
|---|---|---|
| Frontend | QML / Kirigami | KDE Plasma 6 Applet mit CompactRepresentation und FullRepresentation |
| Backend Daemon | Python 3 (Standard Library) | HTTP REST-Server (:48291/stats), 10s TTL-Cache, D-Bus Aktivierung |
| D-Bus Service | org.kde.plasma.claudestat | On-Demand Aktivierung durch Plasma bei Session-Start |
| API Integration | Anthropic OAuth Usage API | Endpunkt api.anthropic.com/api/oauth/usage mit Bearer-Auth |
| Persistenz | SQLite3 | ~/.local/share/kde-claude-stat/history.db für Trendberechnungen |
| OS / Desktop | Linux / KDE Plasma 6 | CachyOS, Arch Linux, Fedora 40+, openSUSE Tumbleweed |