AI 기반 보안 작업을 전문 에이전트, Kali 런타임, 지속적 오케스트레이션으로 수행합니다.
Vigil은 장기간의 공격적 보안 작업을 수행합니다: 웹 앱 펜테스팅 및 버그 바운티 헌팅, 화이트박스 코드 감사, 또는 하나의 대상에 대해 둘 다 수행합니다. 간결한 운영자가 작업을 궤도에 유지하는 동안 전문 에이전트들이 완전한 Kali 런타임 내에서 정찰, 헌팅, 익스플로잇을 수행합니다. 발견 사항은 두 번째 에이전트가 캡처된 증거를 바탕으로 확인할 때만 인정되며, 공격 체인은 그 실제 영향을 보여줍니다. 모든 명령, 요청, 프로브, 발견 사항은 영구 데이터베이스에 기록되므로 작업은 컨텍스트 한계와 재시작을 견디고 이후 감사할 수 있습니다.
승인된 사용만 가능합니다. Vigil은 라이브 시스템에 대해 공격적 도구를 자율적으로 구동합니다. 명시적 승인과 검토된 범위 내에서만 사용하십시오. 이는 Apache License 2.0에 따라 보증 없이 제공됩니다; 명령, 자격 증명, 인프라, 대상 영향에 대한 책임은 사용자에게 있습니다. 비공개 취약점 보고 및 운영자 데이터 경계에 대해서는 SECURITY.md를 참조하십시오.
vigil assess kali를 통해 실행되며, 이는 각 명령의 argv, 에이전트, 단계, 기법, 의도, 프로브 종류, 종료 상태, 출력을 기록합니다. 커버리지 원장은 무엇이 테스트되었고 무엇이 되지 않았는지 보여줍니다.vigil-* 세션 명령, 압축 및 세션 훅. goose, opencode, Kimi는 세션 명령과 압축 훅이 없으며, opencode와 Kimi는 전문가를 인라인으로 실행합니다. Pi는 교정 작업만 지원합니다.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
코드 참여의 경우, 생성 시 출력된 source/ 위치에 소스 파일이나 프로젝트 폴더를 넣으세요
(Git은 선택 사항입니다). 코드 클라이언트는 시작 시 이를 확인하도록 요청하며,
빈 폴더는 대기 상태로 남습니다. 코드 참여에는 호스트에 ripgrep(rg)이 필요합니다. 자세한 내용:
docs/code-analysis.md.
웹 참여의 경우, 운영자에게 수행이 허가된 작업을 알려주세요:
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를 기반으로 구축되었습니다.
| 모델 | 참여 유형 |
|---|---|
| Claude Opus 5, Anthropic의 Cyber Verification Program(CVP) 포함 | 웹 및 코드 |
| GPT-5.6 Sol, OpenAI의 Trusted Access for Cyber 포함 | 웹 및 코드 |
| Claude Opus 5.5, GPT-6.1 Sol | 코드; 웹은 조직 전용 레드팀 티어 필요 |
/model 선택기에 없습니다. /model claude-opus-5[1m]로
직접 선택하십시오(모델 구성)./model에서 GPT-5.6 Sol과 추론 강도를 선택하십시오.2026년 10월 기준, 최신 모델에 대한 레드팀 접근은 조직 전용입니다:
계획 중: 더 예측 가능한 접근이 가능한 GLM 5.3 및 기타 모델에 대한 지원을 확대할 예정이며, 이를 위해 오케스트레이션 오버헤드를 낮추고, 모델별 프롬프트를 사용하며, OpenCode 통합을 심화합니다.
운영자는 작은 컨텍스트를 유지하고 위임합니다. 토큰의 95% 이상이 전문 서브 에이전트에 의해 소비되므로, 하나의 운영자 세션이 훨씬 더 오래 유지됩니다. 사용량 한도에 빠르게 도달할 것으로 예상하십시오.
| 참여 유형 | 추론 강도 | 요금제 |
|---|---|---|
| 코드 | 중간 | 월 $100; 저장소를 완료하기 전에 한도에 도달할 것으로 예상 |
| 코드, 강화된 코드베이스 | 높음 | 월 $200 |
| 웹 | 높음 이상 | 월 $200 |
[!TIP] 버그 바운티: 소스 맵을 찾으십시오.
.map파일을 다운로드하고,vigil assess code-sourcemap-extract로 소스를 복원한 뒤, 그에 대해 코드 참여를 실행하십시오. 그런 다음vigil engagement add-track <key> web과vigil engagement add-host <key> <host>를 실행하여 웹 테스트가 그 결과 위에 구축되도록 하십시오(트랙).
vigil engagement start는 하나의 세션 모드를 선택하고, 사전 점검을 실행하며, 워크스페이스,
참여, 클라이언트, 모드, 단계를 stderr에 출력하고, 참여 환경을 내보내며, 클라이언트를 exec합니다.
자체적으로 소유하지 않은 플래그는 클라이언트로 전달됩니다.vigil engagement start를 통해 시작하십시오. 생성된 start_<client>.sh와 클라이언트 직접 실행은
사전 점검과 환경을 건너뜁니다.--mode web 또는 --mode code가 필요하며, 단일 트랙은
자동으로 선택됩니다. 모드를 변경하려면 새 클라이언트 프로세스를 시작하십시오. vigil engagement mode <key>는
활성화된 트랙, 단계, 프롬프트 경로, 시작 명령을 표시합니다.vigil-resume을 실행하여 운영자 역할을 복원하고
백엔드에서 라이브 상태를 재구축합니다.세부 사항: docs/engagements.md,
docs/session-commands.md,
docs/agent-clients.md.