Paneflow zeigt, wie viel deiner Claude-Code- und Codex-Abos du verbraucht hast, für jedes Konto auf deinem Rechner: eine Kapsel im Fuß der Seitenleiste, eine Blase mit den Details jedes Kontos und eine Seite **Usage** in Settings mit einem Jahr täglicher Aktivität. Paneflow liest nie deine Zugangsdaten oder Tokens und ruft selbst nie eine Usage-API auf. ## Konten [#accounts] Ein Konto ist ein Agent plus ein Konfigurationsverzeichnis. Paneflow listet die Standardverzeichnisse `~/.claude` und `~/.codex`, jeden Space, der `CLAUDE_CONFIG_DIR` oder `CODEX_HOME` in seiner Umgebung setzt, und jedes Agent-Profil, das dies tut. Zwei Spaces, die auf dasselbe Verzeichnis zeigen, teilen sich ein Konto. Ein Konto, das über einen API-Schlüssel abgerechnet wird (`ANTHROPIC_API_KEY`, `OPENAI_API_KEY`), hat keine Plan-Limits und zeigt das auch an. ## Die Kapsel in der Seitenleiste [#the-sidebar-capsule] Die Kapsel sitzt zwischen dem Filter und dem Settings-Button. Ihr Ring und ihr Prozentwert zeigen das engste Limit unter den Konten des aktiven Space oder, wenn der Space keine setzt, unter den Standardkonten. Der Ring nimmt unter 80 % die Akzentfarbe an, ab 80 % Bernstein und ab 95 % Rot. Fahre mit der Maus darüber, um das Konto und das Zeitfenster zu sehen, das sie beschreibt. Klicke auf die Kapsel oder drücke Enter oder Space auf ihr, um die Blase zu öffnen. Jedes Konto zeigt sein Session- und sein Wochenfenster mit einer Balkenanzeige, die Reset-Zeit im Tooltip der Anzeige und eine Tempo-Zeile für die Woche: entweder den Zeitpunkt, an dem du beim aktuellen Tempo das Wochenlimit erreichst, oder den Anteil der Woche, den du beim Reset verbraucht haben wirst. **Open usage settings** ganz unten öffnet die Usage-Seite. Um die Kapsel auszublenden, schalte **Usage** unter **Customize sidebar › Show** aus oder setze `sidebar_show.usage` auf `false`. Ohne Claude-Code- oder Codex-Konto erscheint die Kapsel nicht. ## Die Usage-Seite [#the-usage-page] **Settings › Usage** zeigt pro Konto eine Kachel mit zwei Ringen (außen die Woche, innen die Session), den Reset-Zeiten und der Tempo-Zeile. **Refresh** fragt jedes Konto nach seinen aktuellen Limits. Unter **Activity by agent** erhält jedes Konto mit Aktivität in den letzten 53 Wochen ein Register mit einer Zelle pro Tag. Wechsle die Metrik zwischen **Turns**, **Tokens** (Eingabe und Ausgabe, ohne Cache) und **Active time**. Alle Register teilen eine Skala, eine dunklere Zelle bedeutet also mehr Aktivität, egal bei welchem Agenten. Fahre über einen Tag oder bewege dich, nachdem du per Tab in ein Register gewechselt bist, mit den Pfeiltasten durch die Tage, um die Werte aller Agenten für diesen Tag zu lesen. Paneflow zählt diese Aktivität selbst, anhand der Agenten, die in seinen Panes auf diesem Rechner laufen. Sitzungen, die anderswo laufen, kennt es nicht. ### Vergangene Aktivität importieren [#import-past-activity] Wenn Paneflow zum ersten Mal mit einem leeren Aktivitätsprotokoll startet, liest es im Hintergrund deine vorhandenen Claude-Code-Transkripte (`projects/**/*.jsonl` in jedem Claude-Konfigurationsverzeichnis) und Codex-Sitzungsdateien und füllt die Tage auf, die es noch nicht zählt. **Import past activity** unten auf der Seite startet den Import erneut. Ein zweiter Import zählt nie einen Tag doppelt, und der heutige Tag bleibt immer der Live-Zählung überlassen. Der Import liest die neuesten Dateien zuerst und stoppt nach 10.000 Dateien oder 2 GB. Endet er vorzeitig, zeigt die Seite **Imported the last \{n\} days**. Claude Code behält Transkripte standardmäßig 30 Tage (`cleanupPeriodDays` in seinen Einstellungen), ältere Tage bleiben daher leer. ## Woher die Limits kommen [#where-the-limits-come-from] Paneflow liest Limits nur aus den eigenen Programmen der Agenten, angemeldet mit deinem eigenen Login: - **Claude-Code-Statuszeile.** Wenn du die Claude-Code-Integration installierst und keine eigene Statuszeile hast, setzt Paneflow `statusLine` in den Claude-Einstellungen auf `paneflow-ai-hook StatusLine`. Nach jeder Antwort übergibt Claude Code diesem Befehl die Limits, die es meldet, und Paneflow leitet sie an die Kapsel weiter. Der Befehl gibt nichts aus, deine Statuszeile bleibt also leer. - **Die installierten Claude-Code- und Codex-Binaries.** Wenn du die Blase öffnest oder die Usage-Seite aktualisierst, fragt Paneflow das installierte `claude` nach seiner Nutzung, ohne eine Nachricht zu senden, und `codex app-server` nach seinen Rate-Limits. Jedes Konto wird höchstens einmal alle 30 Sekunden abgefragt. - **Codex-Sitzungsdateien.** Nach jedem Codex-Turn liest Paneflow die Limits, die Codex in seine neueste Sitzungsdatei geschrieben hat. Die jüngste Messung eines Kontos gewinnt. ### Wenn du eine eigene Statuszeile hast [#if-you-have-your-own-status-line] Paneflow ändert nie eine Statuszeile, die du konfiguriert hast. Es liest deine Limits stattdessen aus dem installierten Claude-Code-Binary, die Kapsel funktioniert also genauso. Bis diese Abfrage gelingt, zeigt das Konto: "Claude Code has not reported plan limits for \{folder\} yet. Check that it is installed and signed in for this folder, then reopen this panel." ## Was Paneflow speichert [#what-paneflow-stores] Alles bleibt im Ordner `usage` des Paneflow-Homes (`~/.paneflow`, `%USERPROFILE%\.paneflow` unter Windows): - `usage/plans.json`: pro Konto der verbrauchte Prozentsatz und die Reset-Zeit jedes Fensters, der Zeitpunkt der Abfrage und die Version des Agenten. - `usage/ledger.json`: pro Konto und Tag der letzten 400 Tage die Anzahl der Turns, die aktive Zeit und die Eingabe- und Ausgabe-Tokens, dazu Pfad und Leseposition der Transkripte, die es liest. Es speichert keinen Prompt- oder Antworttext. ## Ausschalten [#turn-it-off] Setze `usage.plan_limits` in `paneflow.json` auf `false`, um die Kapsel auszublenden. Wenn Paneflow seine Claude-Code-Integration das nächste Mal aktualisiert, beim Start oder mit `paneflow integrations install claude-code`, entfernt es auch die Statuszeile, die es gesetzt hat. `paneflow integrations remove claude-code` entfernt sie ebenfalls.