claude-ss - ferramenta que cola capturas de tela no Claude Code no macOS com um clique de cmd+shift+2.

claude-ss

Criei uma ferramenta que cola capturas de tela no Claude Code no macOS com um clique de cmd+shift+2.

Contexto

Colar uma única captura de tela no Claude Code é mais trabalhoso do que parece. Se você capturar com cmd+shift+4, o arquivo vai para a área de trabalho e depois é preciso encontrá-lo e arrastá-lo. Mesmo copiando para a área de transferência com ctrl+cmd+shift+4, ainda é necessário trocar de aba e apertar cmd+v.
Mesmo que você queira colar 3 imagens em uma única rodada, a área de transferência só lembra da última. O claude-ss reduz esse processo para "atalho → arrastar → pronto".

Como funciona

1. De qualquer lugar, pressione cmd+shift+2 → arraste a área
2. Capture várias imagens em sequência (elas ficam acumuladas na fila de multishot)
3. Ao voltar para o terminal do Claude Code, elas são coladas automaticamente na ordem em que foram capturadas

O daemon do claude-ss detecta o foco no terminal e esvazia a fila. Sem piscadas na tela, sem sobrescrever a área de transferência e sem o inferno de ficar trocando de app. Mesmo com IME de coreano/japonês/chinês ativo, o helper em Swift cuida automaticamente de mudar para ABC → colar → restaurar o IME original.

Recursos

• Fila de multishot: mesmo capturando várias imagens, todas são coladas na ordem correta
• IME-safe: cola com segurança mesmo no modo de entrada em coreano
• Suporte a tmux / iTerm2 / cmux: fixa o alvo com base no ID da sessão (claude-ss target set)
• Comandos slash do Claude Code: /ss, /ss-all, /ss-clear também permitem controle manual
• Open source MIT, gratuito

Instalação

npm install -g @jidohyun/claude-ss  
claude-ss setup    # guia para os 3 tipos de permissões do macOS  
claude-ss start  

Ou como plugin do Claude Code:

/plugin marketplace add jidohyun/claude-ss
/plugin install claude-ss@claude-ss

Links

• GitHub: https://github.com/jidohyun/claude-ss
• npm: https://www.npmjs.com/package/@jidohyun/claude-ss

Se você usa o Claude Code, compartilhe com outras pessoas! Feedbacks e PRs de port para Linux e Windows são bem-vindos.