KClaude

KClaude ist ein KDE-Plasma-6-Panel-Widget für Claude Code: Sessions mit Name, Verzeichnis und Session-ID merken, per Klick in einem echten Terminal fortsetzen, auf einen Blick sehen welche Session gerade auf Sie wartet.

Funktionen

  • Sessions speichern und per Klick in konsole fortsetzen — automatisch im richtigen Verzeichnis
  • Live-Status-Ampel pro Session: läuft oder wartet auf Eingabe
  • Panel-Benachrichtigung (+ optionaler Warnton), wenn Claude auf eine Entscheidung wartet
  • Bildschirmausschnitt per Klick direkt in die Zwischenablage — praktisch zum Einfügen in eine Claude-Code-Session
  • Rate-Limit-Kontingent (5h/7-Tage-Fenster + Reset-Zeit) für Claude.ai Pro/Max, direkt im Panel
  • Zeigt, wie lange Claude Code eine Session noch lokal aufbewahrt (cleanupPeriodDays), und blendet gespeicherte Sessions abgeblasst ein, deren Verlauf bereits automatisch gelöscht wurde — bevor ein --resume ins Leere läuft
  • 🍪 Cookie-Button: schickt ein Dankeschön als echten Tastatur-Input in die aktive Session (per tmux send-keys, optional)
  • KRunner-Plugin (optional, separat installierbar): kc <Name> in KRunner (Alt+Leertaste) tippen, um eine gespeicherte Session ohne Panel-Umweg zu fokussieren oder fortzusetzen
  • Kompatibel mit KDE Plasma 6 (Qt 6)
KClaude Plasmoid: Session-Liste mit Live-Status, Rate-Limit-Kontingent, Umbenennen-Icons, Import-Button und Cookie-Button
KClaude Plasmoid: Formular zum Speichern einer neuen Session

Technische Voraussetzungen

KClaude basiert auf:

- Qt ≥ 6.7
- KDE Frameworks ≥ 6.10
- Claude Code CLI
- konsole, gdbus, paplay, jq — für Session-Start und Notification-Hooks

Installation

KClaude ist reines QML, kein Kompilieren nötig. Am einfachsten über "Neue Widgets holen" in den Systemeinstellungen, oder das .plasmoid aus dem letzten Release laden und:


kpackagetool6 --type Plasma/Applet --install kclaude-*.plasmoid
                            

Wer lieber zypper/apt die Updates verwalten lässt, gibt es auch als richtiges Paket. openSUSE Tumbleweed über den Open Build Service:


sudo zypper ar -f https://download.opensuse.org/repositories/home:/Agundur/openSUSE_Tumbleweed/home:Agundur.repo
sudo zypper --gpg-auto-import-keys ref
sudo zypper in kclaude
                            

Für Debian/Ubuntu das .deb aus dem letzten Release laden.

In unserem GitHub-Repository finden Sie die vollständige Anleitung, inklusive der Claude-Code-Hook-Konfiguration für Benachrichtigungen und das Rate-Limit-Kontingent.

Das optionale KRunner-Plugin (kc <Name>) gibt es ebenfalls fertig verpackt im KDE Store (Archiv entpacken, install.sh ausführen, kein sudo nötig) — oder manuell aus dem GitHub-Repository (krunner/-Ordner).

Quellcode & Mitwirken

Der vollständige Quelltext ist unter GPLv2/GPLv3 veröffentlicht. Fehlerberichte, Feature-Wünsche oder Pull Requests sind jederzeit willkommen.

Zum GitHub-Repository
KDE PlasmaLicense: GPLv3PayPal
Logo githubMy Github
mastodon logoFollow me
Logo hire meHire me
Logo EmailEmail