VigIA - análise local, achados na nuvem

A extensão VigIA analisa o código no seu computador (Cursor, VS Code ou Kiro) e envia para a sua conta em vigiasast.com.br somente os achados - trechos de código e segredos não saem da máquina.

O que ela faz

Selecionar uma ou mais pastas do projeto (não depende do workspace aberto).
Rodar varredura local (Semgrep, Gitleaks, boas práticas Mérito, etc., conforme o motor embutido).
Sincronizar achados com o painel web e o histórico de análises.
Abrir o arquivo ao clicar no achado e Corrigir na IDE (chat com prompt pronto).
Práticas e melhorias só nas pastas monitoradas - arquivos fora da lista do painel não são sinalizados.
Separar Vulnerabilidades e Conformidade / boas práticas no painel lateral.

Instalação

Cursor / Open VSX: busque VigIA na aba Extensions ou abra Open VSX - vigia.vigia-security.

VS Code Marketplace: vigia.vigia-security.

VSIX manual: vigiasast.com.br/app/local-agent → Extensions → Install from VSIX.

Release (mantenedores)

Incremente version neste package.json.
Na raiz do repositório: npm run extension:release:openvsx (PAT OSXVIGIA_API_KEY no .env).
Commit do VSIX + dashboard/src/lib/extensions.ts, push main, publicar site na KingHost.

Depois: painel VigIA, login com a conta do site e Selecionar pasta.

Uso rápido

VigIA: Selecionar pasta para analisar - escolha a raiz do repositório.
Aguarde a varredura; o resumo mostra achados e quantos arquivos foram analisados.
Na pasta, use as abas Vulnerabilidades | Conformidade.
Corrigir na IDE abre o chat já com o prompt de correção (confirme antes de executar).

Configuração

Configuração	Descrição
`vigia.apiUrl`	URL da API (padrão: produção VigIA).
`vigia.localScan.onSave`	Reanalisa após salvar arquivos.
`vigia.localScan.debounceSeconds`	Espera antes de reanalisar ao salvar.
`vigia.localScan.maxParallel`	Pastas analisadas ao mesmo tempo (padrão 3, máx. 8).

Ferramentas de varredura

Na primeira análise, a extensão baixa Gitleaks e OSV-Scanner e instala Semgrep com Python 3 - sem Homebrew nem terminal. Baseline, licenças e boas práticas já vêm embutidos.

No Mac/Linux você precisa de Python 3 (geralmente já vem no sistema). Se o Semgrep não instalar, os outros scanners continuam rodando.

Privacidade

O motor roda localmente. O payload enviado à conta contém metadados dos achados (arquivo, linha, regra, mensagem), não o conteúdo completo dos arquivos.

Suporte

Documentação e planos: vigiasast.com.br