https://github.com/krugerrgabriel/simple-claude-usage
✻ Claude usage meter in your GNOME top bar — see your Claude Code / Pro / Max 5-hour session and weekly limits at a glance. Zero dependencies.
https://github.com/krugerrgabriel/simple-claude-usage
anthropic claude claude-ai claude-code developer-tools gjs gnome gnome-extension gnome-shell-extension linux rate-limit top-bar ubuntu usage-monitor
Last synced: 8 days ago
JSON representation
✻ Claude usage meter in your GNOME top bar — see your Claude Code / Pro / Max 5-hour session and weekly limits at a glance. Zero dependencies.
- Host: GitHub
- URL: https://github.com/krugerrgabriel/simple-claude-usage
- Owner: krugerrgabriel
- License: mit
- Created: 2026-06-10T20:05:52.000Z (14 days ago)
- Default Branch: main
- Last Pushed: 2026-06-10T21:05:56.000Z (14 days ago)
- Last Synced: 2026-06-10T22:14:24.616Z (14 days ago)
- Topics: anthropic, claude, claude-ai, claude-code, developer-tools, gjs, gnome, gnome-extension, gnome-shell-extension, linux, rate-limit, top-bar, ubuntu, usage-monitor
- Language: JavaScript
- Size: 63.5 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.de.md
- License: LICENSE
Awesome Lists containing this project
README
✻ Simple Claude Usage
Dein Claude-Verbrauch, immer sichtbar in der GNOME-Topbar.
Nie wieder vom "Limit erreicht" überrascht werden — 5-Stunden-Session und Wochenlimit auf einen Blick.
🇺🇸 English ·
🇧🇷 Português ·
🇪🇸 Español ·
🇩🇪 Deutsch ·
🇯🇵 日本語 ·
🇨🇳 简体中文 ·
🇰🇷 한국어
---
## 💡 Warum
Wenn du **Claude Code**, **Claude Pro** oder **Claude Max** nutzt, kennst du das:
- 🛑 Du bist im Flow und plötzlich: *"Limit erreicht, Reset um…"*
- 🔮 Du weißt nicht, wie nah du am Wochenlimit bist — bis es zu spät ist
- ⌨️ Nachsehen heißt: `/usage` in Claude Code eintippen — jedes Mal
**Simple Claude Usage** bringt die Antwort dahin, wo deine Augen ohnehin sind: in die Topbar.
> **✻ 18%** — das ist alles. Klick drauf für die Details.
---
## ✨ Features
| | |
|---|---|
| 📊 **Immer sichtbar** | Verbrauch der 5-Stunden-Session direkt in der Topbar, minütlich aktualisiert |
| 🖱️ **Details per Klick** | Session-%, Wochen-%, Limits pro Modell und exakte Reset-Zeiten im Dropdown |
| 🌡️ **Farbwarnungen** | Orange ab 70 %, fett rot ab 90 % — keine Überraschungen mehr |
| 🔐 **Kein neuer Login** | Nutzt die Claude-Code-Anmeldedaten, die bereits auf deinem Rechner liegen |
| 🪶 **Null Abhängigkeiten** | ~200 Zeilen pures GJS. Kein Python, kein Node, keine Daemons, keine Telemetrie |
| 🔄 **Selbstheilend** | Token abgelaufen? Es sagt dir Bescheid. Claude Code öffnen genügt |
| 🔔 **Update-Checker** | Prüft einmal täglich GitHub und aktualisiert sich mit einem Klick, wenn eine neue Version erscheint |
---
## 📦 Installation
**Voraussetzungen:** GNOME Shell 42+ (Ubuntu 22.04+, Fedora 36+…) und [Claude Code](https://claude.com/claude-code) mit aktivem Login.
```bash
git clone https://github.com/krugerrgabriel/simple-claude-usage.git
cd simple-claude-usage
./install.sh
```
Dann GNOME Shell neu laden:
- **X11:** Alt+F2 drücken, `r` eingeben, Enter
- **Wayland:** ab- und wieder anmelden
Such nach dem **✻** in deiner Topbar. Fertig!
---
## 🔍 Wie es funktioniert
Die Extension liest das OAuth-Token, das Claude Code bereits in
`~/.claude/.credentials.json` speichert, und fragt **denselben offiziellen
Endpoint** ab wie der `/usage`-Befehl. Sonst nichts:
- ✅ Dein Token verlässt nie deinen Rechner (ein HTTPS-Call zu `api.anthropic.com`, wie bei Claude Code selbst)
- ✅ Die Abfrage verbraucht **nichts** von deinem Plan
- ✅ Keine Konten, keine API-Keys, keine Konfiguration
- ✅ Der Update-Check ist eine einzige anonyme Anfrage pro Tag an die GitHub-API — dein Token ist nie beteiligt
---
## ❓ FAQ
**Die Bar zeigt ✻ — und "Claude Code öffnen".**
Dein OAuth-Token ist abgelaufen. Öffne Claude Code einmal — das Token wird automatisch erneuert und die Anzeige erholt sich innerhalb einer Minute.
**Ich nutze Claude Code täglich, aber es heißt "credentials stale".**
Die Anmeldedaten-Datei auf *diesem* Rechner wird nicht erneuert. Zwei häufige Ursachen: du nutzt Claude Code auf einer anderen Maschine (SSH/WSL/Container), oder deine CLI authentifiziert sich mit einem `ANTHROPIC_API_KEY` statt mit deinem Abo — prüfe mit `/status` in Claude Code und melde dich mit `/login` an. Einmal lokal `claude` ausführen behebt den ersten Fall.
**Funktioniert es mit der API (Pay-as-you-go) statt Abo?**
Noch nicht — es verfolgt Abo-Limits (Pro/Max-Pläne). API-Kosten-Tracking steht auf der Roadmap.
**Läuft es unter KDE / anderen Desktops?**
Nein, es ist eine GNOME-Shell-Extension. GNOME 42–48 werden unterstützt.
**Ist das ein offizielles Anthropic-Projekt?**
Nein. Ein unabhängiges Open-Source-Tool, das deine eigenen Anmeldedaten lokal nutzt.
---
## 🗑️ Deinstallieren
```bash
./uninstall.sh
```
---
## 🔗 Verwandt
- 🔖 [**Claude Sessions Manager**](https://github.com/krugerrgabriel/claude-sessions-manager) — dein täglicher Startpunkt für Claude Code: Konversationen finden, benennen und mit einem Klick fortsetzen.
---
Gemacht mit ✻ von Gabriel Krüger —
wenn dich das vor einem überraschenden Rate-Limit gerettet hat: lass ein ⭐ da!