Vigil

Vigil conduce ingaggi offensivi di sicurezza di lunga durata: pentesting di applicazioni web e bug bounty hunting, audit del codice white-box, o entrambi contro un singolo target. Un operatore snello mantiene l'ingaggio in carreggiata mentre agenti specializzati fanno ricognizione, cacciano ed exploitano all'interno di un runtime Kali completo. Un risultato conta solo quando un secondo agente lo conferma contro le prove catturate, e le catene di attacco ne mostrano l'impatto reale. Ogni comando, richiesta, sonda e risultato finisce in un database durevole, così il lavoro sopravvive ai limiti di contesto e ai riavvii e può essere verificato a posteriori.

Solo uso autorizzato. Vigil guida autonomamente strumenti offensivi contro sistemi live. Usalo solo con autorizzazione esplicita e uno scope revisionato. È fornito senza garanzia sotto la Apache License 2.0; sei responsabile di comandi, credenziali, infrastruttura ed effetti sul target. Vedi SECURITY.md per la segnalazione privata di vulnerabilità e il confine dei dati dell'operatore.

Cosa offre Vigil

• Ingaggi di lunga durata. Lo stato risiede nel backend, quindi un ingaggio sopravvive alla compattazione, ai riavvii e alle nuove sessioni.
• Risultati verificati in modo indipendente. Solo un dispatch diverso da quello dell'autore può confermare, declassare o marcare un risultato come falso positivo, e deve citare una ricevuta di prova delle prove catturate.
• Impatto. Le catene di attacco collegano i risultati in uno sfruttamento end-to-end; per impostazione predefinita, il lavoro di exploit attende la tua approvazione.
• Una traccia di audit. I comandi rivolti al target passano attraverso vigil assess kali, che registra per ogni comando argv, agente, fase, tecnica, intento, tipo di sonda, stato di uscita e output. I registri di copertura mostrano cosa è stato testato e cosa no.
• Strumenti di attacco. Un container Kali di lunga durata con ricognizione ProjectDiscovery, fuzzer, un browser Playwright verificato, cattura MITM con più identità per test cross-account, e callback out-of-band correlati alla sonda che li ha causati.
• Audit del codice white-box. Uno snapshot del sorgente sigillato e content-addressed con un indice strutturale tree-sitter e un registro di copertura.
• Output pronto per la sottomissione. I risultati vengono esportati come write-up Bugcrowd, HackerOne o divulgazione diretta verificati tramite hash.
• Client. Claude Code e Codex hanno pieno supporto: dispatch headless degli specialisti, comandi di sessione vigil-*, e hook di compattazione e sessione. goose, opencode e Kimi mancano di comandi di sessione e hook di compattazione, e opencode e Kimi eseguono gli specialisti inline. Pi supporta solo gli ingaggi di remediation.

Come caccia Vigil

• Nessun bug pre-nominato. Un eccesso di prompt limita ciò che un modello trova. I dispatch portano la superficie, lo scope e le regole di ingaggio, mai il bug da cercare o una checklist. Gli specialisti web scelgono cosa sondare all'interno di quella superficie; i cacciatori di codice ricevono un batch di file e le classi di vulnerabilità da valutare.
• Una lente per caccia. Ogni dispatch di caccia stabilisce quanto ampio andare, come lavorare attraverso i suoi input, e al massimo una lente mentale: sviluppatore, injection, controllo degli accessi, logica di business, impatto della catena, o verificatore scettico.
• Verifica indipendente. Un risultato è confermato solo da un agente diverso che lavora dalle prove catturate. Gli ingaggi sul codice aggiungono una rilettura senza ancore dei file a rischio più alto e una scansione delle varianti su ogni file; il test web percorre ogni rotta sorella, metodo e tipo di contenuto che condivide il percorso di codice vulnerabile.
• Triage kill-first. Le piste web devono superare otto domande ordinate, tra cui se una vera richiesta lo riproduce e se l'impatto è provato. I risultati sul codice devono guadagnarsi un PASS con le stesse prove che servirebbero a un KILL.
• Una libreria di skill, non prompt incollati. Oltre 90 skill e oltre 200 riferimenti si trovano tramite vigil assess list-skills e vigil assess list-references. Gli specialisti web le caricano quando vedono il segnale corrispondente; l'operatore del codice le nomina in ogni dispatch.

Avvio rapido

# 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

Per un ingaggio di tipo code, inserisci i tuoi file sorgente o le cartelle di progetto nella posizione source/ stampata alla creazione (Git è opzionale). Il client code ti chiede di confermarli all'avvio; una cartella vuota lo lascia in attesa. Gli ingaggi di tipo code richiedono ripgrep (rg) sull'host. Dettagli: docs/code-analysis.md.

Per un ingaggio di tipo web, indica all'operatore cosa è autorizzato a fare:

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.

L'interfaccia utente dell'orchestratore è su http://127.0.0.1:18000. Su macOS o Windows Docker Desktop, le operazioni di ricognizione ad alto uso di DNS vengono eseguite sull'host; vigil quickstart --install-host-tools installa tali strumenti. Aggiornamenti e struttura del workspace: docs/installation.md.

Modelli e accesso

Vigil è costruito principalmente attorno a Claude Code e Codex.