winclipshot: ferramenta que permite colar screenshots com Ctrl+V no terminal do Windows
(github.com/Higangssh)Originalmente eu usava isso sozinho no Windows quando utilizava o Claude Code, mas como alguém próximo pediu para compartilhar, transformei em um projeto open source simples.
No terminal do Windows, não é possível colar screenshots com Ctrl+V. Isso acontece porque o terminal não consegue processar os dados de imagem da área de transferência.
O winclipshot fica inscrito nos eventos de alteração da área de transferência e, quando entra uma nova imagem, verifica qual é a janela atualmente em foco:
- Se for um terminal (Windows Terminal, cmd, PowerShell, Alacritty, WezTerm etc.) → salva como PNG e substitui a área de transferência pelo caminho desse arquivo. Ao pressionar Ctrl+V, o caminho é colado, e uma CLI como o Claude Code lê esse caminho para processar a imagem.
- Se for outro app (Slack, Chrome, Word etc.) → mantém a imagem como está, permitindo colar normalmente como de costume.
Não interfere no Win+Shift+S (não registra hotkey global). Se você fechar o exe, tudo volta completamente ao comportamento original.
Também oferece suporte ao fluxo de “fazer screenshot no Chrome → ir para o terminal e colar”. Quando a imagem entra em um app que não é terminal, ela fica em estado "pending" por 60 segundos, e a conversão acontece no momento em que o usuário muda o foco para o terminal.
Como é baseado em eventos, o uso de CPU fica praticamente em 0%, e a memória em cerca de 15 MB. Também inclui a flag de benchmark (-bench) e opções de personalização (-out, -terminals, -pending, -v).
O Claude Code oferece suporte a colar screenshots com Ctrl+V (ou Alt+V), mas isso pode falhar ocasionalmente, e em outras CLIs (sessões ssh, alguns TUIs etc.) esse método nem sequer é suportado ou exige um comando separado (por exemplo, /paste no Aider). O winclipshot permite resolver tudo apenas com “screenshot → Ctrl+V”, independentemente do tipo de CLI.
Foi algo feito de forma simples, mas espero que seja útil para quem precisar, e agradeço qualquer feedback!
4 comentários
Era difícil inserir imagens quando eu escrevia no Clcode, mas depois de usar isto consegui trabalhar de forma muito mais confortável. Obrigado!
Fico feliz que você esteja usando bem, eu que agradeço!
Uau! Vou usar bastante!
Obrigado!