claudlet — Claude Code’un çalışma durumunu görselleştiren piksel masaüstü evcil hayvanı

Terminal kaydırmasını izleyip dururken “Claude şu anda kod mu yazıyor, dosyaları mı inceliyor, yoksa benim yanıtımı mı bekliyor?” diye bunaldığınız oldu mu?
claudlet, Claude Code’un mevcut çalışma durumunu sezgisel ve sevimli biçimde gösteren, tepkisel bir masaüstü piksel evcil hayvanıdır.

Başlıca özellikler

Gerçek zamanlı durum senkronizasyonu: Yazma, dosya okuma, düşünme, bekleme gibi Claude hook’larını yakalayıp bunu evcil hayvanın davranışı ve ifadesiyle anında gösterir.
Alt ajan görselleştirmesi: Claude bir alt ajan çağırdığında, baret takan küçük bir yardımcı ortaya çıkar, peşinizden gelir ve işi taklit eder.
Pencere etkileşimi ve fizik motoru: Yapacak işi yoksa etkin pencere çerçevesi üzerinde yürür. Fareyle tutup fırlatırsanız parabol çizerek uçar; pencere kenarlarına basıp zıplayabilir.
Oturum başına 1:1 eşleşme: Birden fazla oturum açarsanız birden fazla evcil hayvan da görünür. Evcil hayvana tıklarsanız ilgili Claude oturumunun terminal penceresini en öne getirir.

Teknik özellikler (How it works)

Zero-Asset (tamamen kodla render): PNG gibi harici görsel kaynaklar hiç yoktur. Tüm görseller ve animasyonlar (bounce, squash & stretch vb.) QPainter kullanılarak piksel düzeyinde doğrudan kodla çizilmiştir. Bu sayede lisans yükü olmadan özgürce kullanılabilir ve değiştirilebilir.
Güvenli, non-blocking mimari: Yapı Hook → TCP socket → pet process şeklindedir. Evcil hayvan kapalı olsa ya da hata verse bile bağlantı sadece sessizce başarısız olur; Claude Code’un asıl çalışmasını asla engellemez (invariant korunur).
Çapraz platform yerel pencere algılama: Windows (Win32), macOS (Quartz), Linux (KDE Plasma/XWayland) ortamlarında işletim sistemine özgü native API’ler çağrılarak pencere konumu doğru şekilde izlenir ve üstüne çıkılır.

Örnekler

[IMG] Demo 1
[IMG] Demo 2
[IMG] Demo 3

Kurulum ve çalıştırma

pipx install claudlet && claudlet-install

Tek komutla hook’lar ve /claudlet becerisi idempotent şekilde otomatik olarak kaydedilir.
Sonrasında yeni bir Claude Code oturumu açtığınızda evcil hayvan otomatik olarak görünür.