Primeiros Passos com vdiff
Instale o vdiff, configure sua chave de API e rode sua primeira analise de verificacao de codigo de IA em menos de 5 minutos
Instalar
bash
npm install -g @4bk/vdiff
pip install graphifyyO vdiff requer Graphify (Python 3) para construir o grafo de dependências do seu codebase.
No plano gratuito há 15 eventos por dispositivo por dia (cada análise e cada vdiff init concluído conta). Upgrade para Pro para uso ilimitado e suporte offline.
Configurar
Navegue até seu projeto e execute o assistente de configuração interativo:
bash
cd your-project
vdiff initEle guia você por tudo: provedor LLM e chave de API, seleção de modelo, integração com IDE e inicialização do grafo de conhecimento. Execute a partir da raiz do projeto para que o vdiff possa indexar seu codebase.
Provedores suportados: Anthropic (recomendado) e OpenAI.
Execute sua primeira análise
bash
vdiff -vPronto. O vdiff detecta suas mudanças staged (ou unstaged se não houver nada em stage) e produz um relatório de verificação estruturado com todas as seções expandidas.
O que você verá
A saída separa o que factualmente mudou de o que pode estar errado de o que não pode ser verificado:
| Seção | O que mostra |
|---|---|
| Verdict | Prontidão para merge: ready, caution ou not ready |
| Summary | Descrição em linguagem natural da mudança |
| Impact | Raio de impacto: quantos arquivos dependem do que você alterou |
| Findings | Inferências de risco com severidade, confiança e evidência |
| Missing Evidence | O que não pode ser verificado apenas pelo diff |
Indo mais fundo
bash
# Incluir código-fonte completo dos arquivos alterados
vdiff -f
# Análise profunda com modelo mais capaz
vdiff --thinking-level high
# Verificar contra uma spec ou PRD
vdiff -s docs/spec.md
# Diff de branch (revisão estilo PR)
vdiff --base main