Автономный ИИ-агент для тестирования на проникновение, который оркестрирует многоагентную разведку, эксплуатацию уязвимостей, пост-эксплуатацию и формирование отчетов с сохранением состояния кампании.
AI-агент для тестирования на проникновение в вашем терминале.
Мультиагентная архитектура • Отслеживание состояния проекта • 20+ провайдеров LLM
PentestCode — это автономный агент для тестирования на проникновение в вашем терминале. Укажите ему цель, и он запускает инструменты, читает вывод, обновляет свою картину сети и решает, что делать дальше — так, как это сделал бы оператор. Это форк OpenCode (MIT), лишённый фокуса на редактировании кода и перестроенный для наступательной безопасности.
Бета — он держится на реальных проектах и CTF, но ожидайте шероховатостей. Сообщите об ошибке, когда что-то ломается; именно это делает его лучше.
Одна инструкция на входе — полная цепочка атаки на выходе:
you: "pentest 10.10.10.5, goal is domain admin"
| Этап | Что делает агент |
|---|---|
| Сканирование | nmap -sS -p- находит 7 открытых портов и разбирает XML прямо в состояние engagement |
| Распознавание | Порты 88 + 389 → контроллер домена. Запускает три перечислителя параллельно (SMB, LDAP, HTTP) |
| Перечисление | Null-сессия SMB → доступная на запись шара. LDAP → список пользователей. Gobuster → веб-каталоги |
| Атака | AS-REP roast → поддающийся взлому хеш → первые валидные учётные данные |
| Распыление | Эти учётные данные распыляются по SMB, WinRM, LDAP и RDP на каждом известном хосте |
| Эксплуатация | Закрепление через WinRM → постэксплуатационный агент выгружает SAM / LSA / DPAPI |
| Результат | Хеш администратора домена на руках — каждый шаг записан вместе с цепочкой доказательств |
Он методичен там, где люди ленятся: он распыляет каждые учётные данные против каждого сервиса на каждом хосте и не забывает проверять вещи. Всё, что он узнаёт, попадает в структурированное состояние, которое можно запросить прямо во время работы с помощью /status, /vulns или /creds.
npm install -g pentestcode-ai
# via curl
curl -fsSL https://raw.githubusercontent.com/s0ld13rr/pentestcode/main/install.sh | bash
Единый самодостаточный бинарный файл — без необходимости устанавливать Bun, Node или среду выполнения. Linux и macOS, x64 и arm64.
Arch Linux (AUR):
paru -S pentestcode-bin
Зафиксировать версию:
PENTESTCODE_VERSION=0.1.7 curl -fsSL https://raw.githubusercontent.com/s0ld13rr/pentestcode/main/install.sh | bash
Пользовательский каталог:
PENTESTCODE_INSTALL=/usr/local/bin curl -fsSL https://raw.githubusercontent.com/s0ld13rr/pentestcode/main/install.sh | bash
Из источника:
bun install
bun run build --single --skip-embed-web-ui
# binary at packages/opencode/dist/pentestcode-<os>-<arch>/bin/pentestcode
pentestcode auth login # connect your LLM provider
pentestcode # interactive session
pentestcode --prompt "scan 10.10.10.0/24 and enumerate all services" # one-shot
Работает с более чем 20 провайдерами через ai-sdk — Anthropic, OpenAI, Google, Azure, AWS Bedrock, Ollama и другими.
Две вещи отличают PentestCode от промпта пентестера, вставленного в окно чата: команда агентов и общая память.
Дизайн следует модели «стратег-координатор» из исследования HPTSA — улучшение в 4,3 раза по сравнению с одиночным агентом:
┌─────────────┐
│ pentest │ strategist / coordinator
│ (lead) │ plans, dispatches, tracks state
└──────┬──────┘
┌───────┬───────┼───────┬───────┐
▼ ▼ ▼ ▼ ▼
┌──────┐┌──────┐┌──────┐┌──────┐┌──────┐
│recon ││scan- ││explo-││iden- ││post- │
│ ││ner ││iter ││tity ││explo │ ... + 7 more
└──────┘└──────┘└──────┘└──────┘└──────┘
Ведущий агент (pentest) разбивает задачу на подзадачи и параллельно распределяет их между специализированными субагентами — у каждого свой системный промпт, права на инструменты и предметные знания. Всего 13 агентов: recon, scanner, enumerator, exploiter, identity (AD/Kerberos), infrastructure (SNMP/IPMI/базы данных), webapp (OWASP Top 10), post-exploit, exploit-dev, critic (проверка ложных срабатываний), reporter, а также скрытые агенты для сжатия контекста и управления сессиями.
Когда сканер находит порт, enumerator видит его мгновенно — потому что каждый агент читает и записывает в единое структурированное состояние engagement:
Состояние переживает сессию: закройте терминал, вернитесь завтра — и агент продолжит с того места, где остановился. Рядом ведётся человекочитаемый findings.md, в который с временными метками записывается каждая уязвимость, учётные данные и полученный доступ — запустите tail -f, чтобы наблюдать за ходом engagement в реальном времени.
18 встроенных инструментов для пентеста помимо bash. Инструменты-парсеры обязательны: после запуска nmap агент должен пропустить вывод через nmap_parse, а не искать вручную по XML, чтобы каждая находка попадала в состояние engagement.