Maccy + iTerm2 / Warp: um fluxo de clipboard que sobrevive ao terminal

Você rodou kubectl get pods -n staging quarenta minutos atrás. Ajustou as flags duas vezes desde então. Agora precisa da segunda versão, mas copiou outras três coisas no meio do caminho. O histórico do shell guarda o comando, mas não a saída que você copiou, o stack trace que pegou no navegador nem o caminho que arrastou do Finder.

Essa lacuna entre o histórico do shell e o histórico do clipboard é onde um gerenciador de área de transferência se justifica. Este guia mostra como configurar o Maccy Clipboard junto com o iTerm2 ou o Warp, quais ajustes importam, onde as ferramentas se sobrepõem e onde se comportam de forma diferente.

O Maccy funciona com iTerm2 e Warp?

Funciona. O Maccy é um gerenciador de clipboard da barra de menus que monitora a pasteboard do macOS, então qualquer app que copie para a área de transferência do sistema é capturado, terminais incluídos. Não há nenhuma integração específica para instalar. O mesmo vale para o pbcopy: tudo o que você enviar por pipe para ele aparece no histórico do Maccy como qualquer outra cópia.

Cenário	O Maccy captura?	Observações
Selecionar texto no iTerm2 e Cmd+C	Sim	Escrita padrão na pasteboard.
„Copy to pasteboard on selection“ do iTerm2	Sim, mas com muito ruído	Cada seleção vira uma entrada no histórico. Veja as dicas abaixo.
echo "texto" | pbcopy	Sim	Útil para scripts e aliases.
Copiar a saída de um bloco no Warp	Sim	O Warp escreve na pasteboard do sistema.
Clipboard remoto de tmux/SSH via OSC 52	Depende	Só se o terminal tiver permissão para aceitar escritas de clipboard via OSC 52. Veja abaixo.
Texto selecionado dentro do tmux com o modo mouse ativado	Depende	O tmux pode manter a seleção no buffer próprio, a menos que seja configurado para repassá-la ao clipboard do sistema.

Configuração: a versão de cinco minutos

1. Instale. Baixe pelo repositório no GitHub ou rode brew install maccy.
2. Conceda as permissões. Se você quer que o Maccy cole no app em primeiro plano por você, o macOS exige acesso de Acessibilidade (Ajustes do Sistema → Privacidade e Segurança → Acessibilidade). Sem isso, o Maccy apenas copia o item e você cola manualmente com Cmd+V.
3. Troque o modo de busca para Regex. Em Ajustes → Geral do Maccy, mude o modo de busca de fuzzy para expressões regulares [VERIFICAR o nome exato na versão atual]. Os itens copiados no terminal são estruturados, então o regex compensa de imediato.
4. Revise a aba Ignorar. Adicione seu gerenciador de senhas e qualquer outro app que lide com segredos.
5. Resolva o conflito de atalho (próxima seção).

O conflito de atalho de que ninguém avisa

O atalho global padrão do Maccy é Shift+Cmd+C. No iTerm2, essa mesma combinação ativa o Copy Mode, o recurso de seleção de texto pelo teclado. Atalhos globais são registrados no nível do sistema, então, na prática, o Maccy costuma levar a melhor e o Copy Mode para de responder [VERIFICAR na sua versão do macOS]. O Warp também atribui atalhos em torno de combinações com Cmd+Shift, então confira em Settings → Keyboard shortcuts se há sobreposição antes de presumir que está tudo certo.

Você tem duas opções:

• Mudar o atalho do Maccy (geralmente a solução mais simples). Muita gente troca para algo como Cmd+Shift+V ou uma combinação com Option que nenhum terminal use. Abra os ajustes do Maccy e grave um novo atalho.
• Remapear o Copy Mode do iTerm2 em Settings → Keys → Key Bindings, se você realmente o usa no dia a dia.

Escolha uma das duas e teste com o terminal em foco. Um atalho que funciona no Finder pode se comportar de outro jeito em um app que captura teclas de forma agressiva.

Um fluxo de trabalho, não uma lista de recursos

1. Monte um comando a partir de três fontes

Digamos que você copie o nome de um pod de um dashboard, um namespace do Slack e uma flag da documentação. Abra o Maccy, escolha os itens em sequência e cole cada um no prompt. Como o Maccy lista os itens do mais recente para o mais antigo e os numera, voltar três ou quatro entradas leva uma ou duas teclas, em vez de uma viagem de volta a cada app de origem.

2. Pesquise itens copiados com regex

Com o modo regex ligado, dá para filtrar o histórico com precisão. Alguns exemplos:

Você quer	Tente
Qualquer comando git copiado	^git
Qualquer coisa que pareça um caminho absoluto	^/[\w./-]+
Endereços IPv4	\b\d{1,3}(\.\d{1,3}){3}\b
Linhas de stack trace	Exception|Traceback|at .+\(.+:\d+\)
Referências a imagens Docker	[\w.-]+/[\w.-]+:[\w.-]+

3. Fixe o que você vive redigitando

O Maccy permite fixar itens para que fiquem no topo e sobrevivam à limpeza do histórico. Bons candidatos para o trabalho no terminal: a string do seu jump host SSH, um docker run comprido com montagem de volumes, a URL base da API de staging ou uma chamada de rsync com várias flags. Fixar é uma alternativa leve aos aliases do shell quando o trecho muda com frequência ou inclui valores que você prefere não versionar nos dotfiles. O atalho para fixar é Option+P nas versões recentes [VERIFICAR].

4. Cole sem arrastar texto formatado junto

Texto copiado de uma página web pode carregar formatação. Terminais ignoram a maior parte dela, mas o editor de entrada do Warp e algumas ferramentas TUI podem se comportar de forma estranha com caracteres inesperados, como as aspas tipográficas, que quebram comandos do shell sem avisar. O Maccy tem uma ação de colar sem formatação (Option+Shift+Return [VERIFICAR]) que remove a formatação e mantém só o texto simples. Se um comando copiado de um blog „parece certo“ mas falha, as aspas curvas costumam ser as culpadas.

iTerm2 vs Warp: o que muda no uso do clipboard

	iTerm2	Warp
Histórico de clipboard nativo	Sim. Janela Paste History, com opção de salvar em disco [VERIFICAR o nome do ajuste]	Não tem um equivalente completo em todo o sistema, mas o editor de entrada e o histórico de comandos cobrem parte da necessidade
Copiar ao selecionar	Ajuste opcional; inunda o Maccy se estiver ativado	Ajuste opcional [VERIFICAR onde fica]
Segurança ao colar várias linhas	Avisos configuráveis; Advanced Paste para ajustar o texto antes de enviar	O editor de entrada permite revisar e editar texto de várias linhas antes de executar
OSC 52 (clipboard remoto)	Suportado; precisa ser ativado nos ajustes	Consulte a documentação atual [VERIFICAR]
Melhor combinação com o Maccy	Histórico entre apps; o histórico de colagem do iTerm2 continua restrito ao terminal	O editor do Warp facilita inspecionar antes os trechos colados de várias linhas

Uma observação honesta: o Paste History nativo do iTerm2 se sobrepõe ao Maccy quando o assunto é copiar só dentro do terminal. Se você vive inteiramente dentro do iTerm2, talvez nem precise de uma ferramenta separada. O Maccy leva vantagem quando o que você copia vem de todo lado (navegador, Slack, Finder, Xcode) e você quer um único atalho consistente.

Segurança: não deixe seu histórico de clipboard virar um log de segredos

O trabalho no terminal coloca strings sensíveis na área de transferência: tokens de API, valores de .env, chaves SSH, URLs de banco de dados. O Maccy guarda o histórico localmente, sem sincronização na nuvem, o que é uma vantagem real de privacidade. Mas „local“ ainda significa „em disco“, então seja deliberado.

• Ignore seu gerenciador de senhas. Adicione-o nos ajustes de Ignorar do Maccy. Muitos gerenciadores de senhas também marcam suas escritas no clipboard como ocultas (concealed) usando a convenção da comunidade nspasteboard.org, que gerenciadores de clipboard podem respeitar [VERIFICAR se o Maccy respeita esses tipos por padrão].
• Use o ignorar por regex do Maccy para padrões de token. Se a aba Ignorar permitir ignorar por padrão [VERIFICAR], adicione algo como ^(ghp_|sk-|AKIA)[A-Za-z0-9]+ para evitar o armazenamento de formatos comuns de token.
• Limpe o histórico depois de sessões sensíveis. O Maccy tem uma ação de limpar histórico (no menu e por atalho de teclado) justamente para isso.
• Não ignore o terminal por completo. Isso anularia o propósito. Seja seletivo.

Problemas comuns e soluções

Problema	Causa provável	Solução
O histórico se enche de fragmentos	„Copiar ao selecionar“ está ativado	Desative nos ajustes do terminal, ou aceite o ruído e confie na busca
O Maccy abre, mas não cola automaticamente	Falta a permissão de Acessibilidade	Conceda em Ajustes do Sistema → Privacidade e Segurança
O Copy Mode do iTerm2 parou de funcionar	Conflito de atalho	Reatribua o atalho do Maccy
O comando colado falha com caracteres estranhos	Aspas tipográficas ou formatação oculta vindas da origem	Cole sem formatação
A cópia remota via tmux nunca chega ao Maccy	O tmux ou o SSH não está encaminhando para o clipboard do sistema	Ative o OSC 52 no tmux e no terminal [VERIFICAR a sintaxe para o seu caso]
Uma colagem grande trava o shell	Não é o Maccy: o gargalo é o terminal ou o shell	Use a opção de colar devagar do iTerm2 ou salve em um arquivo e execute com source

Onde o Maccy não é a ferramenta certa

O Maccy guarda o que você copia. Ele não entende comandos, não executa snippets com variáveis e não sincroniza entre máquinas. Se você precisa de modelos de comando parametrizados, um gerenciador de snippets ou funções de shell resolvem isso melhor. Se quer o clipboard em dois Macs, o design local-first do Maccy é uma escolha deliberada, não um defeito. E, para recuperar comandos especificamente, a busca reversa com Ctrl+R (ou uma ferramenta como fzf ou atuin) supera qualquer gerenciador de clipboard. Os dois se complementam: o histórico do shell lembra o que você executou, o Maccy lembra o que você copiou.

A versão curta

Instale o Maccy, tire o atalho dele de Shift+Cmd+C, troque para a busca por regex, ignore seu gerenciador de senhas e fixe os poucos trechos que você vive redigitando. São uns cinco minutos de configuração para ter um clipboard no qual você realmente consegue pesquisar. Qual seria o primeiro item que você fixaria: aquela string do jump host ou o docker run que você já digitou cinquenta vezes?