claudlet — un animal de bureau pixelisé qui visualise l’état de travail de Claude Code

Vous est-il déjà arrivé de rester bloqué à regarder le défilement du terminal, sans savoir si « Claude est en train d’écrire du code, de parcourir des fichiers ou d’attendre ma réponse » ?
claudlet est un animal de bureau pixelisé réactif qui affiche de façon intuitive et adorable l’état de travail actuel de Claude Code.

Fonctionnalités principales

Synchronisation d’état en temps réel : il capte les hooks de Claude — frappe, lecture de fichiers, réflexion, attente, etc. — et les affiche immédiatement via les actions et les expressions du pet.
Visualisation des subagents : lorsque Claude appelle un subagent, un petit collègue portant un casque apparaît, suit le pet partout et mime le travail.
Interaction avec les fenêtres & moteur physique : quand il n’a rien à faire, il se promène sur le bord de la fenêtre active. Si vous l’attrapez avec la souris et le lancez, il s’envole en trajectoire parabolique ; il peut aussi prendre appui sur les bords de la fenêtre et sauter.
Correspondance 1:1 par session : si plusieurs sessions sont ouvertes, plusieurs pets apparaissent aussi. En cliquant sur un pet, la fenêtre de terminal de la session Claude correspondante passe au premier plan.

Caractéristiques techniques (How it works)

Zero-Asset (rendu 100 % en code) : aucune ressource image externe comme des PNG. Tous les visuels et toutes les animations (rebond, squash & stretch, etc.) ont été dessinés directement en code, pixel par pixel, avec QPainter. Cela permet de l’utiliser et de le modifier librement, sans contrainte de licence.
Architecture non bloquante et sûre : structure Hook → TCP socket → processus du pet. Même si le pet est arrêté ou rencontre une erreur, la connexion échoue simplement en silence, sans jamais perturber le travail normal de Claude Code (invariant garanti).
Détection native des fenêtres en cross-platform : sous Windows (Win32), macOS (Quartz) et Linux (KDE Plasma/XWayland), il appelle les API natives propres à chaque OS pour suivre précisément la position des fenêtres et grimper dessus.

Exemples

[IMG] Démo 1
[IMG] Démo 2
[IMG] Démo 3

Installation et exécution

pipx install claudlet && claudlet-install

En une seule commande, les hooks et la skill /claudlet sont enregistrés automatiquement de façon idempotente.
Ensuite, dès qu’une nouvelle session Claude Code est ouverte, le pet apparaît automatiquement.