Vigil

Vigil проводит длительные проекты в области наступательной безопасности: пентестинг веб-приложений и bug bounty, white-box аудит кода или и то и другое для одной цели. Компактный оператор удерживает проект в нужном русле, пока специализированные агенты занимаются разведкой, поиском и эксплуатацией внутри полноценной среды Kali. Находка засчитывается только тогда, когда второй агент подтверждает её на основе зафиксированных доказательств, а цепочки атак показывают её реальное воздействие. Каждая команда, запрос, проба и находка попадают в долговременную базу данных, поэтому работа переживает ограничения контекста и перезапуски и может быть проверена впоследствии.

Только авторизованное использование. Vigil автономно управляет наступательными инструментами против живых систем. Используйте его только при наличии явной авторизации и проверенной области действия. Он предоставляется без гарантий в соответствии с Apache License 2.0; вы несёте ответственность за команды, учётные данные, инфраструктуру и воздействие на цели. См. SECURITY.md для приватного сообщения об уязвимостях и границы операторских данных.

Что предоставляет Vigil

• Длительные проекты. Состояние хранится в бэкенде, поэтому проект переживает компактификацию, перезапуски и новые сессии.
• Независимо подтверждённые находки. Только диспетчер, отличный от автора, может подтвердить, понизить в приоритете или пометить находку как ложноположительную, и он должен сослаться на подтверждение в виде зафиксированных доказательств.
• Воздействие. Цепочки атак связывают находки в сквозную эксплуатацию; по умолчанию работа по эксплуатации ожидает вашего одобрения.
• Журнал аудита. Команды, обращённые к цели, выполняются через vigil assess kali, который записывает argv каждой команды, агента, фазу, технику, намерение, вид пробы, статус завершения и вывод. Журналы покрытия показывают, что было протестировано, а что нет.
• Инструменты атаки. Долгоживущий контейнер Kali с разведкой ProjectDiscovery, фаззерами, проверенным браузером Playwright, перехватом MITM с несколькими идентичностями для кросс-аккаунтного тестирования и out-of-band обратными вызовами, соотнесёнными с вызвавшей их пробой.
• White-box аудит кода. Запечатанный снимок исходного кода с адресацией по содержимому, структурный индекс tree-sitter и журнал покрытия.
• Вывод, готовый к отправке. Находки экспортируются в виде проверенных по хешу отчётов для Bugcrowd, HackerOne или прямого раскрытия.
• Клиенты. Claude Code и Codex поддерживаются полностью: headless-диспетчеризация специалистов, сессионные команды vigil-*, а также хуки компактификации и сессий. goose, opencode и Kimi не имеют сессионных команд и хуков компактификации, а opencode и Kimi запускают специалистов inline. Pi поддерживает только проекты по устранению уязвимостей.

Как Vigil ведёт поиск

• Никаких заранее названных багов. Избыточные подсказки ограничивают то, что находит модель. Диспетчеризации несут поверхность, область действия и правила ведения работ, но никогда — баг, который нужно искать, или чек-лист. Веб-специалисты выбирают, что проверять в пределах этой поверхности; охотники за кодом получают пакет файлов и классы уязвимостей для оценки.
• Одна линза на поиск. Каждая диспетчеризация поиска задаёт, насколько широко идти, как прорабатывать свои входные данные, и не более одной линзы мышления: разработчик, инъекции, контроль доступа, бизнес-логика, воздействие цепочки или скептический верификатор.
• Независимая верификация. Находка подтверждается только другим агентом, работающим на основе зафиксированных доказательств. Проекты по коду добавляют повторное чтение файлов с наибольшим риском без привязки и обход вариантов по каждому файлу; веб-тестирование проходит по каждому родственному маршруту, методу и типу контента, разделяющему уязвимый путь кода.
• Триаж с приоритетом отсеивания. Веб-зацепки должны пройти восемь упорядоченных вопросов, включая то, воспроизводит ли её реальный запрос и доказано ли воздействие. Находки по коду должны заслужить PASS с теми же доказательствами, которые потребовались бы для KILL.
• Библиотека навыков, а не вставленные подсказки. 90+ навыков и 200+ справочных материалов находятся через vigil assess list-skills и vigil assess list-references. Веб-специалисты загружают их, когда видят соответствующий сигнал; оператор по коду называет их в каждой диспетчеризации.

Быстрый старт

# 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

Для code-проекта поместите исходные файлы или папки проекта в расположение source/, выведенное при создании (Git необязателен). Клиент code просит подтвердить их при запуске; пустая папка оставляет его в режиме ожидания. Для code-проектов требуется ripgrep (rg) на хосте. Подробности: docs/code-analysis.md.

Для web-проекта сообщите оператору, что ему разрешено делать:

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.

UI оркестратора доступен по адресу http://127.0.0.1:18000. В macOS или Windows Docker Desktop разведка с интенсивным использованием DNS выполняется на хосте; vigil quickstart --install-host-tools устанавливает эти инструменты. Обновления и структура рабочего пространства: docs/installation.md.

Модели и доступ

Vigil построен в первую очередь вокруг Claude Code и Codex.