Haben Sie auch schon frustriert nur auf das Terminal-Scrolling gestarrt und sich gefragt, ob Claude gerade Code schreibt, Dateien durchsucht oder auf Ihre Antwort wartet?
claudlet ist ein reaktives Desktop-Pixel-Pet, das den aktuellen Arbeitsstatus von Claude Code intuitiv und auf niedliche Weise anzeigt.
Hauptfunktionen
- Echtzeit-Statussynchronisierung: Erfasst Claudes Hooks wie Tippen, Dateilesen, Nachdenken oder Warten und zeigt sie sofort über Verhalten und Gesichtsausdruck des Pets an.
- Visualisierung von Sub-Agents: Wenn Claude einen Sub-Agent aufruft, erscheint ein kleiner Helfer mit Schutzhelm, läuft hinterher und ahmt die Arbeit nach.
- Fensterinteraktion & Physik-Engine: Wenn es nichts zu tun gibt, läuft es auf dem Rahmen des aktiven Fensters entlang. Wenn man es mit der Maus greift und wirft, fliegt es in einer Parabel davon, tritt auf Fensterkanten und springt auch.
- 1:1-Zuordnung pro Sitzung: Wenn mehrere Sitzungen geöffnet sind, erscheinen auch mehrere Pets. Klickt man auf ein Pet, wird das Terminalfenster der zugehörigen Claude-Sitzung in den Vordergrund geholt.
Technische Besonderheiten (How it works)
- Zero-Asset (reines Code-Rendering): Es gibt keinerlei externe Bildressourcen wie PNGs. Sämtliche Artworks und Animationen (Bounce, Squash & Stretch usw.) wurden mit
QPainterpixelgenau direkt im Code gezeichnet. Dadurch lässt sich das Projekt ohne Lizenzaufwand frei nutzen und anpassen. - Sichere nicht-blockierende Architektur: Die Struktur ist
Hook → TCP socket → Pet-Prozess. Selbst wenn das Pet beendet ist oder ein Fehler auftritt, schlägt nur die Verbindung still fehl; die eigentliche Arbeit von Claude Code wird niemals beeinträchtigt (Invariante garantiert). - Plattformübergreifende native Fenstererkennung: Unter Windows (Win32), macOS (Quartz) und Linux (KDE Plasma/XWayland) werden je nach OS native APIs aufgerufen, um Fensterpositionen präzise zu verfolgen und darauf zu klettern.
Beispiele
[IMG] Demo 1
[IMG] Demo 2
[IMG] Demo 3
![[IMG] Demo 1](https://raw.githubusercontent.com/YeeDochi/Claudlet/master/docs/demo-3.gif){kind=link}
![[IMG] Demo 2](https://raw.githubusercontent.com/YeeDochi/Claudlet/master/docs/companion_demo.gif){kind=link}
![[IMG] Demo 3](https://raw.githubusercontent.com/YeeDochi/Claudlet/master/docs/companion.gif){kind=link}
Installation und Ausführung
pipx install claudlet && claudlet-install
- Mit einem einzigen Befehl werden Hook und der
/claudlet-Skill automatisch idempotent registriert. - Danach erscheint das Pet automatisch, sobald eine neue Claude-Code-Sitzung geöffnet wird.
Noch keine Kommentare.