claudlet — Thú cưng desktop pixel trực quan hóa trạng thái làm việc của Claude Code

Bạn từng thấy bức bối khi chỉ nhìn terminal cuộn mà không biết “Claude hiện đang viết code, lục tìm file, hay chờ phản hồi của mình” chưa?
claudlet là một thú cưng desktop pixel tương tác, hiển thị trạng thái làm việc hiện tại của Claude Code một cách trực quan và dễ thương.

Tính năng chính

Đồng bộ trạng thái theo thời gian thực: Bắt các hook của Claude như đang gõ, đọc file, đang suy nghĩ, chờ đợi, v.v. và lập tức thể hiện bằng hành vi cùng biểu cảm của thú cưng.
Trực quan hóa sub-agent: Khi Claude gọi sub-agent, một đồng nghiệp tí hon đội mũ bảo hộ sẽ xuất hiện, lẽo đẽo đi theo và mô phỏng công việc.
Tương tác với cửa sổ & engine vật lý: Khi không có việc gì làm, nó sẽ đi dọc khung cửa sổ đang hoạt động. Nếu bạn dùng chuột nhấc lên ném, nó sẽ bay theo quỹ đạo parabol, và cũng có thể đạp vào mép cửa sổ để nhảy.
Ghép 1:1 theo phiên: Nếu mở nhiều phiên, nhiều thú cưng cũng sẽ xuất hiện. Nhấp vào thú cưng sẽ đưa cửa sổ terminal của phiên Claude tương ứng lên phía trước.

Đặc điểm kỹ thuật (How it works)

Zero-Asset (render hoàn toàn bằng code): Không có bất kỳ tài nguyên ảnh bên ngoài nào như PNG. Toàn bộ artwork và animation (bounce, squash & stretch, v.v.) được vẽ trực tiếp bằng code ở cấp pixel với QPainter. Nhờ đó có thể tự do sử dụng và chỉnh sửa mà không phải lo gánh nặng giấy phép.
Kiến trúc non-blocking an toàn: Cấu trúc là Hook → TCP socket → tiến trình thú cưng. Ngay cả khi thú cưng đã tắt hoặc gặp lỗi, nó chỉ âm thầm không kết nối được, tuyệt đối không cản trở công việc gốc của Claude Code (đảm bảo invariant).
Nhận diện cửa sổ native đa nền tảng: Trên Windows (Win32), macOS (Quartz), Linux (KDE Plasma/XWayland), claudlet gọi các API native theo từng OS để theo dõi chính xác vị trí cửa sổ và trèo lên đó.

Ví dụ

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

Cài đặt và chạy

pipx install claudlet && claudlet-install

Chỉ với một lệnh, các hook và skill /claudlet sẽ được tự động đăng ký theo cách lũy đẳng (Idempotent).
Sau đó, khi mở một phiên Claude Code mới, thú cưng sẽ tự động xuất hiện.