Diese Übersetzung kann hinter der englischen README zurückliegen; maßgeblich ist die englische Fassung.

Warum

Wer mit mehreren AI-Tools programmiert, stößt immer wieder an dieselbe Wand: Das 5-Stunden-Limit ist mitten in der Aufgabe aufgebraucht, du öffnest ein anderes Tool und erklärst alles von vorn. Jeder Anbieter zeigt seine Nutzung an einer anderen Stelle, manche gar nicht.

Vibe Usage liest die Sitzungen, die auf deinem Rechner bereits angemeldet sind, und zeigt alle Limits nebeneinander: wie viel übrig ist und wann es zurückgesetzt wird. Wird ein Tool knapp, startet es das nächste mit verifiziertem Kontingent in deinem Projektordner und schreibt eine Zusammenfassung der aktuellen Sitzung, damit das neue Tool dort weitermacht, wo das alte aufgehört hat.

Funktionen

Kontingente auf einen Blick Jedes Limit jedes Kontos: 5-Stunden- und Wochenfenster, modellbezogene Kontingente, Ausgabenbudgets. Countdowns zeigen, wann jedes zurückgesetzt wird. Schlägt eine Aktualisierung fehl, bleibt der letzte Messwert sichtbar und ist klar als veraltet markiert. Unbekannte Werte werden nie als volles Kontingent angezeigt. Fahren Sie über das Tray-Symbol, um zu sehen, was jedem Tool noch bleibt; auf Wunsch benachrichtigt die App, wenn ein Limit knapp oder wieder verfügbar wird. Die App kann bei der Anmeldung starten.
Smart-Start Wählt das erste Tool in deiner Prioritätsreihenfolge, dessen Kontingent verifiziert noch Luft hat, und öffnet es in einem neuen Terminal im gewählten Projektordner. Lässt sich kein Tool verifizieren, sagt es das, statt zu raten.
Übergabe Wähle eine Sitzung aus Claude Code, Codex, Cursor Agent oder Antigravity. VIBE_HANDOVER.md enthält Ziel, letzte Anfrage, jüngsten Gesprächsverlauf, Dateiverweise und Git-Branch/HEAD-Metadaten; der Arbeitsbaum wird nicht untersucht. Die Vorschau bindet die physische Quelle, das Konto und die Version. Eine geänderte Quelle braucht eine neue Vorschau; in einen Worktree verlagerte Sitzungen erscheinen beim richtigen Projekt.
Mehrere Konten Claude und Codex speichern eine Anmeldung pro Profilordner. Konto hinzufügen legt einen neuen Ordner an und öffnet dort die Anmeldung des Tools; selbst angelegte ~/.claude-*- und ~/.codex-*-Ordner werden automatisch gefunden. Jedes Konto wird mit der E-Mail-Adresse seiner Anmeldung angezeigt, und auch jedes angemeldete Antigravity-Konto wird getrennt verfolgt. Wähle das Hauptkonto, starte Claude Code mit einem bestimmten Konto und lege die Ausweichreihenfolge sowie das bevorzugte Modell pro Tool fest. Eine Anmeldung, die nicht innerhalb von zehn Minuten abgeschlossen ist, entfernt das Konto wieder; das nächste Konto verwendet seinen Ordner.

Einstellungen, Verlauf und Diagnose

Allgemein: Start bei der Anmeldung, Benachrichtigung an deiner Knapp-Grenze, Ruhezeiten, Konten nebeneinander und die Update-Prüfung.	Wenn ein Limit erreicht ist: nur vorschlagen, auf den anderen Konten des Tools weitermachen oder danach mit den anderen Tools in Ausweichreihenfolge; auch pro Projekt.	Reihenfolge und Modelle: wie die Tools aufgelistet werden, welches als Nächstes übernimmt, mit welchem Modell jedes startet und wie oft das Kontingent gelesen wird.
Übergabeverlauf: welche Arbeit von welchem Konto wohin gewechselt ist; eine fehlgeschlagene mit einem Klick erneut versuchen.	Diagnose: ob jedes Tool installiert ist und wie es jedem Konto geht; ein Bericht ohne Namen und Ordner zum Kopieren oder Speichern.

Unterstützte Tools

Tool	Woher das Kontingent kommt	Sitzungen für die Übergabe	Start
Claude Code	OAuth-Nutzungsendpunkt des Profils (unter macOS aus dem Schlüsselbund)	~/.claude/projects	claude CLI mit dem gewählten Profil
Codex	Ratenlimit-Methoden des App-Servers der installierten CLI	~/.codex/sessions	codex CLI
Cursor	Nutzungsübersicht der angemeldeten Sitzung	Cursor-Agent-CLI-Chats (~/.cursor/chats)	cursor-agent, sonst die App
Antigravity	Lokaler Dienst der laufenden App (Prozess- und Port-Besitz geprüft)	~/.gemini/antigravity-ide	Antigravity-App

Modelllisten stammen aus den eigenen Daten jedes Tools: Claude-Code-Aliasse und die von dir genutzten Modelle, der Codex-Modellcache und cursor-agent --list-models (24 Stunden zwischengespeichert).

Datenschutz und Sicherheit

Vorhandene Anmeldedaten werden im Speicher gelesen; die Dokumente können Zugriffs- und Refresh-Tokens enthalten. Die App prüft, ob ein Refresh-Token vorhanden ist, speichert es aber nicht in ihren eigenen Daten. Die Erneuerung übernimmt Claude Code.

Einstellungen, Kontobezeichnungen, Pfade, Kontingentverlauf und letzte Messungen bleiben lokal auf der Festplatte. Beim Kontowechsel wird das vollständige Gespräch kopiert. VIBE_HANDOVER.md enthält bereinigten Gesprächskontext; unbekannte Geheimnisformate können unerkannt bleiben. Prüfe die Vorschau vor der Übergabe. Bereits von Git verfolgte Dateien oder ein fehlgeschlagener Git-Ausschluss stoppen die Übergabe. Cursor behält seine Vertrauensabfragen.

Kontingentabfragen nutzen die Anbieter-Endpunkte, Versionsprüfungen GitHub. Download und Installation eines Updates sind getrennte Benutzeraktionen. Einzelheiten stehen unter Datenschutz und lokale Daten.

Installation

Windows

Lade Vibe-Usage-<version>-win-setup.exe aus dem neuesten Release herunter und starte es: Es installiert nur für deinen Benutzer, ohne Administratorrechte. Oder nimm die portable Vibe-Usage-<version>-win-x64.zip (oder -arm64), entpacke sie und starte Vibe Usage.exe. Eine unterstützte signierte Installation lädt Updates erst nach Klick auf Herunterladen und installiert sie mit Neu starten und aktualisieren. Die portable Kopie verlinkt eine neue Version. Die App sitzt im Infobereich.

Die App ist nicht codesigniert, daher meldet Windows SmartScreen beim ersten Start eventuell Der Computer wurde durch Windows geschützt. Klicke auf Weitere Informationen und dann auf Trotzdem ausführen.

macOS

Lade Vibe-Usage-<version>-mac-arm64.dmg (Apple Silicon; Intel: -mac-x64.dmg) aus dem neuesten Release herunter, öffne es und ziehe Vibe Usage in den Ordner „Programme“. Die App ist noch nicht mit einer Apple Developer ID signiert, daher blockiert Gatekeeper den ersten Start: Öffne Systemeinstellungen › Datenschutz & Sicherheit und klicke auf Dennoch öffnen, oder führe aus:

xattr -dr com.apple.quarantine "/Applications/Vibe Usage.app"

Um diesen Schritt zu sparen, baust du sie selbst. Du brauchst nur Node.js 24:

git clone https://github.com/mustafacagri/vibe-usage.git && cd vibe-usage
npm ci
npm run build:mac
cp -R "release/mac-arm64/Vibe Usage.app" /Applications/

Auf einem Intel-Mac heißt der Ordner release/mac. Eine selbst gebaute App wird nicht unter Quarantäne gestellt und öffnet sich direkt. macOS lässt nur eine signierte App sich selbst ersetzen, daher wird eine neue Version genauso installiert: Die Schaltfläche Herunterladen in der App lädt das passende Disk-Image für deinen Mac.

Kommandozeile

Dieselben Daten gibt es im Terminal, unter Windows und macOS, mit oder ohne Desktop-App. Die CLI braucht Node.js 24 oder neuer und liest dieselben angemeldeten Sitzungen wie die App; sind beide installiert, teilen sie Einstellungen und Sprache.

npm install -g vibe-usage-cli
vibe-usage status

vibe-usage status [--json]   # das Kontingent aller Konten einmal; --json für Skripte
vibe-usage watch             # dasselbe, aktualisiert bis Strg+C
vibe-usage run <claude|codex|cursor> [--account ID] [--cwd PATH] [--model MODEL] [--dry-run]
vibe-usage handover [--from TOOL] [--to TOOL] [--session ID] [--cwd PATH]
vibe-usage help

Ohne Installation ausprobieren: npx vibe-usage-cli status.

run startet das Tool in diesem Terminal mit einem Konto mit verifiziertem Kontingent; andernfalls nenne eines mit --account (die IDs stehen in status --json). --dry-run gibt Konto und Befehl aus, ohne etwas zu starten. handover schreibt VIBE_HANDOVER.md für die neueste Sitzung des Ordners (oder --session) und öffnet damit das Zieltool.

Entwicklung

Befehle, Projektstruktur und Umgebungsvariablen findest du im Abschnitt „Development“ der englischen README.

Einschränkungen

• Der macOS-Build ist nicht notarisiert (siehe macOS).
• Das Modell einer Antigravity-Sitzung stammt aus einem undokumentierten lokalen Eintrag; ist es nicht lesbar, bleibt das Modell leer.
• Chats aus der Cursor IDE (Composer) können nicht übergeben werden; nur Sitzungen der Cursor Agent CLI werden gelesen.

Lizenz

MIT