safemerge
Saiba se a sua branch pode ser mergeada antes do merge acontecer.
Conflitos (inclusive com outros PRs e os que o git não vê), segurança e riscos de produção do que a sua branch introduz, direto no VS Code.
Por que usar
O git só avisa do conflito na hora do merge, e só do conflito de texto. O que costuma quebrar produção é outra coisa:
- dois PRs que cada um passa sozinho e juntos conflitam ou quebram os testes;
- a
dev renomeou uma função que o seu PR ainda chama: o git junta sem reclamar e o deploy quebra;
- um token commitado e apagado no commit seguinte, que continua no histórico;
- uma dependência nova com script de instalação, ou com uma vulnerabilidade conhecida;
- uma migração com o mesmo número de outra branch;
- código novo com N+1, HTTP sem timeout, SQL concatenado,
.env commitado.
O safemerge responde antes do merge, sem alterar nada no seu repositório: pode mergear? Se não, por quê, onde (arquivo e linha), com a evidência, e o que não foi verificado.
Como funciona (3 passos)
- Abra a pasta de um repositório git e entre na branch que você quer mergear.
- Clique no escudo na barra lateral e em Analisar branch.
- Veja o veredito na barra de status: Pode mergear, Mergear com atenção ou Não mergear. Clique para abrir o relatório completo.
Em segundos você tem a resposta. Não precisa instalar mais nada: a análise já vem dentro da extensão.
O que você vê no VS Code
| Conflito sublinhado no código, na aba Problemas e na barra de status |
CodeLens e hover com o código do destino e como era antes |
 |
 |
| Segurança: achados na barra lateral e a notificação |
Pode mergear |
 |
 |
- Barra lateral: veredito, motivos, fases, conflitos, outros PRs, achados de segurança e a cobertura (o que rodou e o que não).
- No código: o conflito aparece sublinhado e na aba Problemas, com um CodeLens acima ("conflita com dev · quem mexeu por último") e um hover com o código do destino.
- Relatório completo: o painel mostra a sua branch, como o trecho era antes e o destino, lado a lado.
- Barra de status e som: o veredito fica sempre à vista, e toca um som quando pode mergear.
Tudo que ele analisa
| Área |
Verificações |
| Merge |
conflito com o destino e com as outras branches principais; arquivo apagado de um lado e alterado do outro; conflito só em lockfile (avisa para regenerar); mesma função alterada pelos dois lados; renomeação no destino; branch atrasada |
| Outros PRs |
quem vai conflitar com o seu, quem altera a mesma função, PR empilhado |
| Testes no merge |
roda os seus testes no resultado do merge (conflito semântico), diz a causa e não acusa teste instável |
| Segurança |
segredos em todos os commits; dependência com script de instalação ou de fora do registro; CVE nova; workflow de CI perigoso; SAST no código novo |
| Deploy e domínio |
migração duplicada, fora de ordem ou mais antiga que uma aplicada; variável de ambiente nova; função removida no destino e ainda usada; dado pessoal em log (LGPD); rota sem autenticação; consulta sem filtro de tenant |
| Revisão do código novo |
marcador de conflito commitado; SQL concatenado; .env/chave commitados; TLS desligado; N+1; HTTP sem timeout; exceção engolida; depuração esquecida; migração destrutiva |
Como o veredito é decidido: um achado só bloqueia com arquivo, linha e evidência. O que é heurística avisa, mas não bloqueia sozinho. E cada verificação diz se rodou, rodou parcialmente (regras internas no lugar de uma ferramenta que você não tem) ou ficou sem cobertura. O relatório nunca mostra "0 problemas" sem ter verificado.
Clique em Resolver com IA (na barra lateral, no painel ou na notificação). A extensão monta um pedido com os trechos dos dois lados de cada conflito, os achados com arquivo e linha, e as regras (propor sem aplicar, verificar antes de mostrar), e:
- abre o chat do VS Code com o pedido pronto, e
- copia para a área de transferência, para você colar no assistente que usa (Claude Code, Cursor, Copilot, outro).
A extensão não chama nenhuma IA sozinha e não envia nada para lugar nenhum. A IA propõe, você decide.
Comandos
Abra a paleta (Ctrl+Shift+P) e digite safemerge.
| Comando |
O que faz |
| Analisar branch |
analisa a branch aberta |
| Abrir relatório |
mostra o relatório completo |
| Resolver com IA |
manda o pedido para o chat do VS Code e copia |
| Copiar relatório (texto) |
para compartilhar |
| Copiar relatório para o PR (Markdown) |
para colar na descrição do PR |
| Salvar relatório… |
txt, md, html, pedido para IA, sarif ou json |
| Instalar hook pre-push |
barra o git push de uma branch com "não mergear" |
| Testar som |
ouve os sons de pode mergear, atenção e não mergear |
Configurações
| Configuração |
Padrão |
Para quê |
safemerge.testCommand |
vazio |
comando de testes rodado no resultado do merge (ex.: npm test) |
safemerge.analyzeOnSave |
desligado |
analisar ao salvar um arquivo |
safemerge.sound |
ok |
som: só quando pode mergear (ok), sempre (always) ou nunca (never) |
safemerge.soundStyle |
safemerge |
som próprio ou do sistema |
safemerge.cliPath |
vazio |
usar outra instalação do safemerge no lugar da embutida |
Ajustes do projeto (destino padrão, modelos com tenant, rotas públicas…) ficam em .safemerge/config.json no repositório. Veja a documentação completa.
Somente leitura
O safemerge nunca altera a sua branch, o índice ou os seus arquivos. Merges, testes e propostas rodam em cópias temporárias (git worktree). O único lugar em que ele escreve é .safemerge/runs/ (o histórico das análises, que se ignora no git sozinho) e .git/hooks/pre-push se você pedir o hook. Acesso à rede: só o git fetch do seu remoto e, se instalado, o gh para listar PRs.
Requisitos
- VS Code 1.85 ou mais novo e git 2.38 ou mais novo.
- Opcional, para aumentar a cobertura: gitleaks, zizmor, semgrep, OSV-Scanner, Mergiraf, Docker e o GitHub CLI (
gh) logado. Sem eles, o safemerge usa regras internas e diz isso no relatório.
Perguntas frequentes
Aparece "gh não conseguiu listar PRs". É problema? Não. O gh só dá nome aos PRs (número, autor, título). A comparação com as outras branches continua igual.
O que é "cobertura parcial"? A ferramenta especializada não está instalada e o safemerge usou as regras internas dele (menos regras). "Sem cobertura" significa que a verificação não rodou.
Funciona com qualquer linguagem? Merge, outros PRs, testes no merge, segredos, workflows, lockfiles e migrações não dependem da linguagem. As heurísticas de código cobrem JS/TS, Python, Go, Java/Kotlin e partes de Ruby, PHP e Dart.
Funciona no Windows, Linux e macOS? Sim, os três são testados no CI.
A mesma análise também roda no terminal, em hook pre-push, no GitHub Actions (com marcas na linha do diff do PR) e como plugin do Claude Code. Veja tudo no repositório.
Gostou?
O safemerge é gratuito e de código aberto. Se ele te poupou de um merge quebrado, deixe uma avaliação aqui na aba Classificações e Revisões e uma ⭐ no GitHub. Encontrou algo errado? Abra uma issue, de preferência com um repositório mínimo que reproduza.