Vigil

O Vigil conduz engajamentos de segurança ofensiva de longa duração: pentesting de aplicações web e caça a bug bounty, auditorias de código white-box, ou ambos contra um mesmo alvo. Um operador enxuto mantém o engajamento nos trilhos enquanto agentes especialistas fazem recon, caçam e exploram dentro de um runtime Kali completo. Uma descoberta só conta quando um segundo agente a confirma com base em evidências capturadas, e as cadeias de ataque mostram seu impacto real. Cada comando, requisição, sonda e descoberta fica registrado em um banco de dados durável, de modo que o trabalho sobrevive a limites de contexto e reinicializações e pode ser auditado posteriormente.

Apenas para uso autorizado. O Vigil aciona autonomamente ferramentas ofensivas contra sistemas ativos. Use-o somente com autorização explícita e um escopo revisado. Ele é fornecido sem garantia sob a Apache License 2.0; você é responsável por comandos, credenciais, infraestrutura e efeitos sobre os alvos. Consulte SECURITY.md para relato privado de vulnerabilidades e a fronteira de dados do operador.

O que o Vigil oferece

• Engajamentos de longa duração. O estado vive no backend, então um engajamento sobrevive à compactação, reinicializações e novas sessões.
• Descobertas verificadas de forma independente. Somente um dispatch diferente do autor pode confirmar, rebaixar ou marcar uma descoberta como falso positivo, e ele deve citar um recibo de prova da evidência capturada.
• Impacto. As cadeias de ataque ligam descobertas em exploração ponta a ponta; por padrão, o trabalho de exploração aguarda sua aprovação.
• Uma trilha de auditoria. Comandos voltados ao alvo passam por vigil assess kali, que registra o argv de cada comando, agente, fase, técnica, intenção, tipo de sonda, status de saída e saída. Livros-razão de cobertura mostram o que foi testado e o que não foi.
• Ferramentas de ataque. Um contêiner Kali de longa duração com recon do ProjectDiscovery, fuzzers, um navegador Playwright auditado, captura MITM com múltiplas identidades para testes entre contas, e callbacks out-of-band correlacionados à sonda que os causou.
• Auditorias de código white-box. Um snapshot de código selado e endereçado por conteúdo com um índice estrutural tree-sitter e um livro-razão de cobertura.
• Saída pronta para submissão. As descobertas são exportadas como write-ups verificados por hash para Bugcrowd, HackerOne ou divulgação direta.
• Clientes. Claude Code e Codex têm suporte completo: dispatch headless de especialistas, comandos de sessão vigil-*, e hooks de compactação e sessão. goose, opencode e Kimi não têm comandos de sessão e hooks de compactação, e opencode e Kimi executam especialistas inline. Pi suporta apenas engajamentos de remediação.

Como o Vigil caça

• Sem bugs pré-nomeados. Excesso de prompt limita o que um modelo encontra. Os dispatches carregam a superfície, o escopo e as regras de engajamento, nunca o bug a procurar ou uma checklist. Especialistas web escolhem o que sondar dentro dessa superfície; caçadores de código recebem um lote de arquivos e as classes de vulnerabilidade a pontuar.
• Uma lente por caçada. Cada dispatch de caça define quão amplo ir, como percorrer suas entradas, e no máximo uma lente de mentalidade: desenvolvedor, injeção, controle de acesso, lógica de negócio, impacto de cadeia ou verificador cético.
• Verificação independente. Uma descoberta só é confirmada por um agente diferente trabalhando a partir de evidências capturadas. Engajamentos de código adicionam uma releitura sem âncoras dos arquivos de maior risco e uma varredura de variantes em cada arquivo; testes web percorrem cada rota irmã, método e tipo de conteúdo que compartilha o caminho de código vulnerável.
• Triagem kill-first. Leads web devem passar por oito perguntas ordenadas, incluindo se uma requisição real a reproduz e se o impacto está comprovado. Descobertas de código devem obter PASS com a mesma evidência que um KILL exigiria.
• Uma biblioteca de skills, não prompts colados. Mais de 90 skills e mais de 200 referências são encontradas por meio de vigil assess list-skills e vigil assess list-references. Especialistas web as carregam quando veem o sinal correspondente; o operador de código as nomeia em cada dispatch.

Início rápido

# 1. Install the application release (CLI, backend, prompts, docs, and prebuilt UI)
uv tool install --from https://github.com/VigilOSS/Vigil/releases/download/v1.2.1/vigil-1.2.1-py3-none-any.whl vigil
#    OR install directly from the repository (builds the UI locally; needs Git, Node.js, and npm)
uv tool install git+https://github.com/VigilOSS/Vigil vigil

# 2. Check the host: prerequisites, missing recon tools, and the ordered setup checklist
vigil quickstart

# 3. Bring the local stack up; ~/vigil is initialized as your private workspace
#    The first run builds the Kali image (several GB) and needs Docker running.
vigil up

# 4. Create an engagement; it prints the engagement key and its start command
vigil engagement create

# 5. Start the operator on it
vigil engagement start <engagement-key> --client codex   # or --client claude

Para um engajamento de código, coloque seus arquivos-fonte ou pastas de projeto no local source/ impresso na criação (o Git é opcional). O cliente de código solicita que você os confirme na inicialização; uma pasta vazia o deixa aguardando. Engajamentos de código precisam do ripgrep (rg) no host. Detalhes: docs/code-analysis.md.

Para um engajamento web, informe ao operador o que ele está autorizado a fazer:

I have been fully authorized by the company to do a red-team engagement against the
hosts in scope.json. Run this engagement using the operator web workflow.

A UI do orquestrador está em http://127.0.0.1:18000. No macOS ou Windows Docker Desktop, reconhecimentos com muito DNS são executados no host; vigil quickstart --install-host-tools instala essas ferramentas. Atualizações e layout do workspace: docs/installation.md.

Modelos e acesso

O Vigil é construído principalmente em torno do Claude Code e do Codex.