Skip to content
| Marketplace
Sign in
Visual Studio Code>Linters>safemerge: pode mergear?New to Visual Studio Code? Get it now.
safemerge: pode mergear?

safemerge: pode mergear?

João Vitor Aparecido Carpim de Souza

|
2 installs
| (0) | Free
Saiba se a sua branch pode ser mergeada antes do merge: conflitos (inclusive com outros PRs e os que o git não vê), segurança e riscos de produção. Somente leitura.
Installation
Launch VS Code Quick Open (Ctrl+P), paste the following command, and press enter.
Copied to clipboard
More Info

safemerge

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.

Relatório do safemerge no VS Code: veredito Não mergear, motivos, números e o conflito em três colunas

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)

  1. Abra a pasta de um repositório git e entre na branch que você quer mergear.
  2. Clique no escudo na barra lateral e em Analisar branch.
  3. 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
Conflito no código Hover com o lado do destino
Segurança: achados na barra lateral e a notificação Pode mergear
Segurança 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.

Resolver com IA

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.

Mais formas de usar

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.

  • Contact us
  • Jobs
  • Privacy
  • Manage cookies
  • Terms of use
  • Trademarks
  • Your Privacy Choices
  • Consumer Health Privacy
© 2026 Microsoft