Vigil

Vigil ejecuta compromisos de seguridad ofensiva de larga duración: pentesting de aplicaciones web y caza de bug bounties, auditorías de código de caja blanca, o ambos contra un mismo objetivo. Un operador ágil mantiene el compromiso encaminado mientras agentes especialistas hacen reconocimiento, cazan y explotan dentro de un runtime Kali completo. Un hallazgo solo cuenta cuando un segundo agente lo confirma contra la evidencia capturada, y las cadenas de ataque muestran su impacto real. Cada comando, petición, sonda y hallazgo queda registrado en una base de datos duradera, de modo que el trabajo sobrevive a los límites de contexto y a los reinicios, y puede auditarse después.

Solo para uso autorizado. Vigil impulsa autónomamente herramientas ofensivas contra sistemas en vivo. Úsalo únicamente con autorización explícita y un alcance revisado. Se proporciona sin garantía bajo la Apache License 2.0; tú eres responsable de los comandos, las credenciales, la infraestructura y los efectos sobre los objetivos. Consulta SECURITY.md para el reporte privado de vulnerabilidades y el límite de datos del operador.

Qué ofrece Vigil

• Compromisos de larga duración. El estado vive en el backend, por lo que un compromiso sobrevive a la compactación, los reinicios y las nuevas sesiones.
• Hallazgos verificados de forma independiente. Solo un dispatch distinto al del autor puede confirmar, degradar o marcar un hallazgo como falso positivo, y debe citar un recibo de prueba de la evidencia capturada.
• Impacto. Las cadenas de ataque enlazan hallazgos en una explotación de extremo a extremo; por defecto, el trabajo de explotación espera tu aprobación.
• Una pista de auditoría. Los comandos dirigidos al objetivo se ejecutan a través de vigil assess kali, que registra el argv de cada comando, el agente, la fase, la técnica, la intención, el tipo de sonda, el estado de salida y la salida. Los libros de cobertura muestran qué se probó y qué no.
• Herramientas de ataque. Un contenedor Kali de larga vida con reconocimiento de ProjectDiscovery, fuzzers, un navegador Playwright auditado, captura MITM con múltiples identidades para pruebas entre cuentas, y callbacks fuera de banda correlacionados con la sonda que los causó.
• Auditorías de código de caja blanca. Una instantánea de código sellada y direccionada por contenido con un índice estructural de tree-sitter y un libro de cobertura.
• Salida lista para envío. Los hallazgos se exportan como informes de Bugcrowd, HackerOne o divulgación directa verificados por hash.
• Clientes. Claude Code y Codex tienen soporte completo: dispatch de especialistas sin interfaz, comandos de sesión vigil-*, y hooks de compactación y sesión. goose, opencode y Kimi carecen de comandos de sesión y hooks de compactación, y opencode y Kimi ejecutan especialistas en línea. Pi solo admite compromisos de remediación.

Cómo caza Vigil

• Sin bugs prenombrados. Sobrepromptear limita lo que un modelo encuentra. Los dispatches llevan la superficie, el alcance y las reglas de enfrentamiento, nunca el bug que hay que buscar ni una lista de verificación. Los especialistas web eligen qué sondear dentro de esa superficie; los cazadores de código reciben un lote de archivos y las clases de vulnerabilidad que deben puntuar.
• Una lente por caza. Cada dispatch de caza establece qué tan amplio ir, cómo trabajar a través de sus entradas, y como máximo una lente de mentalidad: desarrollador, inyección, control de acceso, lógica de negocio, impacto de cadena o verificador escéptico.
• Verificación independiente. Un hallazgo solo se confirma por un agente diferente que trabaja a partir de la evidencia capturada. Los compromisos de código añaden una relectura sin anclajes de los archivos de mayor riesgo y un barrido de variantes por cada archivo; las pruebas web recorren cada ruta hermana, método y tipo de contenido que comparte la ruta de código vulnerable.
• Triaje con prioridad de descarte. Los leads web deben pasar ocho preguntas ordenadas, incluida si una petición real lo reproduce y si el impacto está probado. Los hallazgos de código deben ganarse un PASS con la misma evidencia que necesitaría un KILL.
• Una biblioteca de skills, no prompts pegados. Más de 90 skills y más de 200 referencias se encuentran mediante vigil assess list-skills y vigil assess list-references. Los especialistas web las cargan cuando ven la señal correspondiente; el operador de código las nombra en cada dispatch.

Inicio 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 un compromiso de código, coloca tus archivos fuente o carpetas de proyecto en la ubicación source/ impresa durante la creación (Git es opcional). El cliente de código te pide confirmarlos al inicio; una carpeta vacía lo deja esperando. Los compromisos de código necesitan ripgrep (rg) en el host. Detalles: docs/code-analysis.md.

Para un compromiso web, indícale al operador qué está autorizado a hacer:

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.

La interfaz de usuario del orquestador está en http://127.0.0.1:18000. En macOS o Windows Docker Desktop, el reconocimiento con mucho DNS se ejecuta en el host; vigil quickstart --install-host-tools instala esas herramientas. Actualizaciones y diseño del espacio de trabajo: docs/installation.md.

Modelos y acceso