CodeBreak

O que é o CodeBreak?

CodeBreak é um app macOS pequeno projetado para monitorar runs do Claude Code. Seu objetivo principal é manter você informado sobre o estado do Claude Code em toda a sua tela — para que não precise alternar constantemente para o terminal e verificar se ele ainda está em execução, bloqueado, concluído ou encontrou um erro.

Enquanto o Claude Code trabalha, o CodeBreak ajuda você a manter o ritmo ao se afastar, alternar abas ou trabalhar em outros apps. Ele usa presença na tela e sinais sonoros distintos para indicar o que está acontecendo durante o run.

Principais Recursos

• Monitora o Claude Code em todos os apps e janelas, para que o status fique visível sem precisar verificar repetidamente o terminal.
• Cinco animações/ícones de estado com sons correspondentes para representar o que o Claude Code está fazendo (por exemplo, aguardando, processando, precisa de entrada, tarefa concluída, erro).
• Companheiro arrastável na tela que você pode posicionar em qualquer lugar da área de trabalho enquanto o Claude Code está em execução.
• Controles para mostrar/ocultar o personagem e os sons, permitindo gerenciar o que vê e ouve.
• Múltiplos packs de personagens e sons incluídos (quatro personagens e oito packs de som), com possibilidade de combinar e misturar.
• Pausa e retoma as animações do companheiro a qualquer momento.
• Estados sonoros semânticos para eventos chave: “concluído”, “precisa de entrada” e “erro”.

Como Usar o CodeBreak

1. Baixe e instale o CodeBreak para macOS.
2. Certifique-se de que está usando o Claude Code (o CodeBreak é indicado apenas para Claude Code).
3. Inicie um run do Claude Code normalmente.
4. Observe o companheiro do CodeBreak enquanto alterna para outros apps; posicione a janela/sobreposição do companheiro onde não bloqueie seu trabalho.
5. Quando o CodeBreak indicar que precisa de você (som urgente e personagem acelerado), volte ao Claude Code para fornecer entrada. Quando sinalizar tarefa concluída ou erro, verifique os resultados ou solucione problemas conforme necessário.

Casos de Uso

• Reduzir verificações repetidas no terminal: Você inicia um run do Claude Code, então continua trabalhando em outra aba; o companheiro do CodeBreak indica se o run ainda está processando ou mudou para estado novo.
• Capturar “precisa de entrada” imediatamente: O Claude Code pode parar em um ponto de decisão; o CodeBreak detecta essa transição e sinaliza com um som audio