claudlet — Una mascota de escritorio pixel art que visualiza el estado de trabajo de Claude Code

¿Alguna vez te frustraste mirando solo el scroll de la terminal, sin saber si “Claude está escribiendo código, revisando archivos o esperando mi respuesta”?
claudlet es una mascota de escritorio pixel art reactiva que muestra de forma intuitiva y adorable el estado de trabajo actual de Claude Code.

Funciones principales

Sincronización de estado en tiempo real: Captura los hooks de Claude —como escritura, lectura de archivos, pensando o en espera— y los muestra al instante mediante las acciones y expresiones de la mascota.
Visualización de subagentes: Cuando Claude invoca un subagente, aparece un pequeño compañero con casco que lo sigue de cerca e imita su trabajo.
Interacción con ventanas y motor de física: Cuando no tiene nada que hacer, camina por el marco de la ventana activa. Si la tomas con el mouse y la lanzas, vuela describiendo una parábola, y también salta apoyándose en los bordes de las ventanas.
Emparejamiento 1:1 por sesión: Si abres varias sesiones, también aparecen varias mascotas. Al hacer clic en una mascota, se trae al frente la ventana de terminal de la sesión de Claude correspondiente.

Características técnicas (How it works)

Zero-Asset (renderizado con puro código): No usa ningún recurso de imagen externo como PNG. Todo el arte y las animaciones (bounce, squash & stretch, etc.) se dibujan directamente en código, píxel por píxel, usando QPainter. Gracias a eso, se puede usar y modificar libremente sin cargas de licencias.
Arquitectura segura no bloqueante: Usa una estructura Hook → socket TCP → proceso de la mascota. Aunque la mascota esté apagada o falle, la conexión simplemente falla de forma silenciosa, y nunca interfiere con el trabajo original de Claude Code (garantía de invariante).
Reconocimiento nativo de ventanas multiplataforma: En Windows (Win32), macOS (Quartz) y Linux (KDE Plasma/XWayland), llama a las API nativas de cada SO para rastrear con precisión la posición de las ventanas y subirse a ellas.

Ejemplos

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

Instalación y ejecución

pipx install claudlet && claudlet-install

Con un solo comando, los hooks y la skill /claudlet se registran automáticamente de forma idempotente (Idempotent).
Después, al abrir una nueva sesión de Claude Code, la mascota aparece automáticamente.