Você já passou pela frustração de ficar olhando só o scroll do terminal sem saber se o Claude está escrevendo código agora, vasculhando arquivos ou esperando sua resposta?
O claudlet é um pet de desktop reativo em pixel que mostra de forma intuitiva e fofa o estado atual de trabalho do Claude Code.
Principais recursos
- Sincronização de estado em tempo real: captura os hooks do Claude — digitando, lendo arquivos, pensando, em espera etc. — e mostra tudo imediatamente pelo comportamento e pelas expressões do pet.
- Visualização de subagentes: quando o Claude chama um subagente, aparece um pequeno companheiro de capacete, que fica seguindo o pet e imitando o trabalho.
- Interação com janelas & motor de física: quando não há nada para fazer, ele anda pela moldura da janela ativa. Se você pegá-lo com o mouse e jogar, ele voa desenhando uma parábola, pisa nas bordas da janela e também pula.
- Correspondência 1:1 por sessão: se você abrir várias sessões, vários pets também aparecem. Ao clicar em um pet, a janela de terminal daquela sessão do Claude vai para frente.
Características técnicas (How it works)
- Zero-Asset (renderização puramente por código): não há nenhum recurso de imagem externo, como PNG. Toda a arte e animação (bounce, squash & stretch etc.) foi desenhada diretamente em código, pixel por pixel, usando
QPainter. Graças a isso, é possível usar e modificar livremente sem preocupações com licença. - Arquitetura segura e non-blocking: a estrutura é
Hook → TCP socket → processo do pet. Mesmo que o pet esteja desligado ou ocorra algum erro, a conexão apenas falha silenciosamente; o trabalho original do Claude Code nunca é interrompido (invariante garantida). - Reconhecimento nativo de janelas cross-platform: em Windows (Win32), macOS (Quartz) e Linux (KDE Plasma/XWayland), chama APIs nativas de cada sistema para rastrear com precisão a posição das janelas e subir nelas.
Exemplos
[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}
Instalação e execução
pipx install claudlet && claudlet-install
- Com um único comando, o hook e a skill
/claudletsão registrados automaticamente de forma idempotente. - Depois disso, ao abrir uma nova sessão do Claude Code, o pet aparece automaticamente.
Ainda não há comentários.