companion-capture: Ferramenta salva as bolhas de fala efêmeras do Claude Code

O que o companion-capture faz

Se você usa o Claude Code no terminal, provavelmente já notou o personagem companheiro que aparece com balões de fala enquanto você trabalha. Essas mensagens são efêmeras — a TUI é redesenhada e elas desaparecem. Algumas contêm observações úteis sobre seu código, avisos sobre bugs ou comentários engraçados. O companion-capture monitora a saída do terminal, extrai essas mensagens dos balões e as salva em arquivos markdown (e opcionalmente no SQLite para busca).

Como funciona

• Um wrapper de shell inicia o Claude Code através do script -q -F para capturar a saída bruta do terminal
• Um analisador Python executa um buffer de tela VT100 (não remoção ANSI — rastreamento real da posição do cursor) para descobrir onde o texto é realmente renderizado
• As mensagens exigem duas varreduras consecutivas antes de serem gravadas, para que você não receba lixo pela metade
• Um gancho PostToolUse traz novas capturas de volta para o Claude durante a sessão, para que ele possa realmente ver o que o companheiro disse

Recursos

• Zero dependências de tempo de execução (apenas Python da biblioteca padrão)
• Busca de texto completo entre as capturas (companion-capture search "auth bug")
• Controles de privacidade — excluir padrões, listas de bloqueio de projetos, redação retroativa
• Recuperação contextual opcional que alimenta capturas recentes de volta para o Claude automaticamente
• companion-capture doctor para verificar a saúde de toda a configuração
• Mais de 400 casos de teste pytest

O que o desenvolvedor descobriu usando

O companheiro realmente detecta coisas. Ele sinalizou um script de migração que não tinha cobertura de testes. Ele percebeu uma condição de corrida em uma configuração de múltiplas sessões. Na maioria das vezes são vibes e reações, mas a cada poucas sessões ele solta algo genuinamente digno de ler novamente.

Limitações atuais

Apenas MacOS + Claude Code por enquanto. Sem dependências externas, licenciado MIT.

GitHub: github.com/jaywadhwa/companion-capture