Vigil

Vigil führt lang andauernde Offensive-Security-Engagements durch: Web-App-Pentesting und Bug-Bounty-Hunting, White-Box-Code-Audits oder beides gegen ein Ziel. Ein schlanker Operator hält das Engagement auf Kurs, während spezialisierte Agenten innerhalb einer vollständigen Kali-Runtime Recon, Hunting und Exploitation betreiben. Ein Finding zählt nur, wenn ein zweiter Agent es anhand erfasster Beweise bestätigt, und Angriffsketten zeigen seine tatsächliche Auswirkung. Jeder Befehl, jede Anfrage, jede Sonde und jedes Finding landet in einer dauerhaften Datenbank, sodass die Arbeit Kontextgrenzen und Neustarts übersteht und im Nachhinein auditiert werden kann.

Nur zur autorisierten Nutzung. Vigil steuert offensive Tooling autonom gegen Live-Systeme. Verwende es nur mit ausdrücklicher Autorisierung und einem geprüften Scope. Es wird ohne Gewährleistung unter der Apache License 2.0 bereitgestellt; du bist verantwortlich für Befehle, Zugangsdaten, Infrastruktur und Auswirkungen auf Ziele. Siehe SECURITY.md für private Schwachstellen- meldungen und die Operator-Datengrenze.

Was Vigil bietet

• Lang laufende Engagements. Der Zustand liegt im Backend, sodass ein Engagement Kompaktierung, Neustarts und neue Sitzungen übersteht.
• Unabhängig verifizierte Findings. Nur ein Dispatch, der nicht vom Autor stammt, kann ein Finding bestätigen, herabstufen oder als False Positive markieren, und muss dabei einen Proof-Receipt erfasster Beweise zitieren.
• Auswirkung. Angriffsketten verknüpfen Findings zu End-to-End-Exploitation; standardmäßig wartet Exploit-Arbeit auf deine Freigabe.
• Ein Audit-Trail. Zielgerichtete Befehle laufen über vigil assess kali, wodurch argv, Agent, Phase, Technik, Intent, Probe-Art, Exit-Status und Ausgabe jedes Befehls aufgezeichnet werden. Coverage-Ledger zeigen, was getestet wurde und was nicht.
• Angriffs-Tooling. Ein langlebiger Kali-Container mit ProjectDiscovery-Recon, Fuzzern, einem auditierten Playwright-Browser, MITM-Capture mit mehreren Identitäten für Cross-Account-Tests und Out-of-Band-Callbacks, die der auslösenden Sonde zugeordnet werden.
• White-Box-Code-Audits. Ein versiegelter, inhaltsadressierter Quellcode-Snapshot mit einem tree-sitter- Strukturindex und einem Coverage-Ledger.
• Einreichungsfertige Ausgabe. Findings lassen sich als hash-verifizierte Bugcrowd-, HackerOne- oder direkte Disclosure-Write-ups exportieren.
• Clients. Claude Code und Codex werden vollständig unterstützt: Headless-Specialist-Dispatch, vigil-*- Sitzungsbefehle sowie Kompaktierungs- und Sitzungs-Hooks. goose, opencode und Kimi fehlen Sitzungs- befehle und Kompaktierungs-Hooks, und opencode und Kimi führen Spezialisten inline aus. Pi unterstützt nur Remediation-Engagements.

Wie Vigil jagt

• Keine vorab benannten Bugs. Zu viel Prompting begrenzt, was ein Modell findet. Dispatches tragen die Oberfläche, den Scope und die Rules of Engagement, niemals den zu suchenden Bug oder eine Checkliste. Web-Spezialisten wählen selbst, was sie innerhalb dieser Oberfläche sondieren; Code-Hunter erhalten einen Datei-Batch und die zu bewertenden Schwachstellenklassen.
• Eine Linse pro Jagd. Jeder Hunting-Dispatch legt fest, wie breit vorgegangen wird, wie die Eingaben durchgearbeitet werden und höchstens eine Mindset-Linse: Entwickler, Injection, Access Control, Business Logic, Chain Impact oder skeptischer Verifier.
• Unabhängige Verifikation. Ein Finding wird nur von einem anderen Agenten bestätigt, der anhand erfasster Beweise arbeitet. Code-Engagements ergänzen ein ankerfreies erneutes Lesen der risikoreichsten Dateien und einen Varianten-Sweep über jede Datei; Web-Tests gehen jede Schwester-Route, Methode und jeden Content-Type durch, die sich den verwundbaren Codepfad teilen.
• Kill-First-Triage. Web-Leads müssen acht geordnete Fragen bestehen, darunter, ob eine echte Anfrage es reproduziert und ob die Auswirkung bewiesen ist. Code-Findings müssen PASS mit denselben Beweisen verdienen, die ein KILL bräuchte.
• Eine Skill-Bibliothek, keine eingefügten Prompts. 90+ Skills und 200+ Referenzen sind über vigil assess list-skills und vigil assess list-references auffindbar. Web-Spezialisten laden sie, wenn sie das passende Signal sehen; der Code-Operator benennt sie in jedem Dispatch.

Schnellstart

# 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

Für ein Code-Engagement legen Sie Ihre Quelldateien oder Projektordner im source/-Verzeichnis ab, das bei der Erstellung ausgegeben wird (Git ist optional). Der Code-Client fordert Sie beim Start auf, diese zu bestätigen; ein leerer Ordner lässt ihn warten. Code-Engagements erfordern ripgrep (rg) auf dem Host. Details: docs/code-analysis.md.

Für ein Web-Engagement teilen Sie dem Operator mit, wozu er autorisiert ist:

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.

Die Orchestrator-UI ist unter http://127.0.0.1:18000 erreichbar. Unter macOS oder Windows Docker Desktop laufen DNS-lastige Recon-Aufgaben auf dem Host; vigil quickstart --install-host-tools installiert diese Tools. Upgrades und Workspace-Layout: docs/installation.md.

Modelle und Zugriff

Vigil basiert primär auf Claude Code und Codex.