Vigil

Vigil mène des engagements de sécurité offensive de longue durée : pentesting d'applications web et chasse aux bug bounties, audits de code en boîte blanche, ou les deux contre une même cible. Un opérateur minimal garde l'engagement sur les rails tandis que des agents spécialisés font la reconnaissance, la chasse et l'exploitation au sein d'un runtime Kali complet. Un résultat ne compte que lorsqu'un second agent le confirme à partir de preuves capturées, et les chaînes d'attaque montrent son impact réel. Chaque commande, requête, sonde et résultat atterrit dans une base de données durable, de sorte que le travail survit aux limites de contexte et aux redémarrages et peut être audité par la suite.

Usage autorisé uniquement. Vigil pilote de manière autonome des outils offensifs contre des systèmes en production. Utilisez-le uniquement avec une autorisation explicite et un périmètre validé. Il est fourni sans garantie sous la Licence Apache 2.0 ; vous êtes responsable des commandes, des identifiants, de l'infrastructure et des effets sur les cibles. Voir SECURITY.md pour le signalement privé de vulnérabilités et la frontière des données opérateur.

Ce que Vigil fournit

• Engagements de longue durée. L'état réside dans le backend, de sorte qu'un engagement survit à la compaction, aux redémarrages et aux nouvelles sessions.
• Résultats vérifiés de manière indépendante. Seule une dispatch autre que celle de l'auteur peut confirmer, rétrograder ou marquer un résultat comme faux positif, et elle doit citer un reçu de preuve des éléments capturés.
• Impact. Les chaînes d'attaque relient les résultats en une exploitation de bout en bout ; par défaut, le travail d'exploitation attend votre approbation.
• Une piste d'audit. Les commandes dirigées vers la cible passent par vigil assess kali, qui enregistre l'argv, l'agent, la phase, la technique, l'intention, le type de sonde, le statut de sortie et la sortie de chaque commande. Les registres de couverture montrent ce qui a été testé et ce qui ne l'a pas été.
• Outillage d'attaque. Un conteneur Kali de longue durée avec la reconnaissance ProjectDiscovery, des fuzzers, un navigateur Playwright audité, la capture MITM avec plusieurs identités pour les tests multi-comptes, et des callbacks hors bande corrélés à la sonde qui les a provoqués.
• Audits de code en boîte blanche. Un instantané source scellé et adressé par contenu avec un index structurel tree-sitter et un registre de couverture.
• Sortie prête à la soumission. Les résultats s'exportent sous forme de rapports Bugcrowd, HackerOne ou de divulgation directe vérifiés par hash.
• Clients. Claude Code et Codex sont pleinement pris en charge : dispatch de spécialistes en mode headless, commandes de session vigil-*, et hooks de compaction et de session. goose, opencode et Kimi n'ont pas de commandes de session ni de hooks de compaction, et opencode et Kimi exécutent les spécialistes en ligne. Pi ne prend en charge que les engagements de remédiation.

Comment Vigil chasse

• Aucun bug pré-nommé. Le sur-prompting plafonne ce qu'un modèle trouve. Les dispatchs portent la surface, le périmètre et les règles d'engagement, jamais le bug à chercher ni une checklist. Les spécialistes web choisissent ce qu'ils sondent dans cette surface ; les chasseurs de code reçoivent un lot de fichiers et les classes de vulnérabilités à évaluer.
• Une seule lentille par chasse. Chaque dispatch de chasse définit l'ampleur à couvrir, la manière de traiter ses entrées, et au plus une lentille d'état d'esprit : développeur, injection, contrôle d'accès, logique métier, impact de chaîne, ou vérificateur sceptique.
• Vérification indépendante. Un résultat n'est confirmé que par un agent différent travaillant à partir des preuves capturées. Les engagements de code ajoutent une relecture sans ancrage des fichiers les plus à risque et un balayage des variantes sur chaque fichier ; les tests web parcourent chaque route sœur, méthode et type de contenu qui partage le chemin de code vulnérable.
• Triage kill-first. Les pistes web doivent passer huit questions ordonnées, notamment si une requête réelle la reproduit et si l'impact est prouvé. Les résultats de code doivent obtenir PASS avec les mêmes preuves qu'un KILL exigerait.
• Une bibliothèque de compétences, pas des prompts collés. Plus de 90 compétences et 200 références sont accessibles via vigil assess list-skills et vigil assess list-references. Les spécialistes web les chargent lorsqu'ils voient le signal correspondant ; l'opérateur de code les nomme dans chaque dispatch.

Démarrage rapide

# 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

Pour un engagement de type code, placez vos fichiers sources ou dossiers de projet dans l'emplacement source/ indiqué lors de la création (Git est facultatif). Le client de code vous demande de les confirmer au démarrage ; un dossier vide le laisse en attente. Les engagements de code nécessitent ripgrep (rg) sur l'hôte. Détails : docs/code-analysis.md.

Pour un engagement de type web, indiquez à l'opérateur ce qu'il est autorisé à faire :

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.