Autonomer KI-Penetrationstest-Agent, der Multi-Agenten-Aufklärung, Exploitation, Post-Exploitation und Berichterstellung mit persistentem Engagement-Zustand orchestriert.
KI-Penetrationstesting-Agent in deinem Terminal.
Multi-Agenten-Architektur • Engagement-Statusverfolgung • 20+ LLM-Anbieter
PentestCode ist ein autonomer Pentesting-Agent für dein Terminal. Richte ihn auf ein Ziel und er führt die Tools aus, liest die Ausgabe, aktualisiert sein Bild des Netzwerks und entscheidet, was als Nächstes zu tun ist — so wie es ein Operator tun würde. Ein Hard Fork von OpenCode (MIT), befreit vom Fokus auf Code-Bearbeitung und neu aufgebaut für offensive Sicherheit.
Beta — er hält sich bei echten Engagements und CTFs, aber rechne mit Ecken und Kanten. Reiche ein Issue ein, wenn etwas kaputtgeht; genau das macht ihn besser.
Eine Anweisung rein, eine vollständige Angriffskette raus:
you: "pentest 10.10.10.5, goal is domain admin"
| Phase | Was der Agent tut |
|---|---|
| Scan | nmap -sS -p- findet 7 offene Ports und parst das XML direkt in den Engagement-Status |
| Erkennen | Ports 88 + 389 → Domain Controller. Fächert drei Enumeratoren parallel auf (SMB, LDAP, HTTP) |
| Enumerieren | Null-SMB-Session → beschreibbare Freigabe. LDAP → Benutzerliste. Gobuster → Web-Verzeichnisse |
| Angriff | AS-REP-Roasting → knackbarer Hash → erste gültige Anmeldeinformation |
| Spray | Diese Anmeldeinformation wird gegen SMB, WinRM, LDAP und RDP auf jedem bekannten Host gesprüht |
| Ausnutzen | WinRM-Foothold → Post-Exploit-Agent dumpt SAM / LSA / DPAPI |
| Ergebnis | Domain-Admin-Hash in der Hand — jeder Schritt mit seiner Beweiskette aufgezeichnet |
Es arbeitet methodisch dort, wo Menschen nachlässig werden: Es sprüht jede Anmeldeinformation gegen jeden Dienst auf jedem Host und vergisst nicht, Dinge zu prüfen. Alles, was es lernt, landet in einem strukturierten Status, den du mitten im Lauf mit /status, /vulns oder /creds abfragen kannst.
npm install -g pentestcode-ai
# via curl
curl -fsSL https://raw.githubusercontent.com/s0ld13rr/pentestcode/main/install.sh | bash
Eine einzelne, in sich geschlossene Binärdatei — kein Bun, Node oder eine Laufzeitumgebung zu installieren. Linux und macOS, x64 und arm64.
Arch Linux (AUR):
paru -S pentestcode-bin
Version pinnen:
PENTESTCODE_VERSION=0.1.7 curl -fsSL https://raw.githubusercontent.com/s0ld13rr/pentestcode/main/install.sh | bash
Benutzerdefiniertes Verzeichnis:
PENTESTCODE_INSTALL=/usr/local/bin curl -fsSL https://raw.githubusercontent.com/s0ld13rr/pentestcode/main/install.sh | bash
Aus Quelle:
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
Funktioniert mit über 20 Anbietern über ai-sdk — Anthropic, OpenAI, Google, Azure, AWS Bedrock, Ollama und mehr.
Zwei Dinge unterscheiden PentestCode von einem in ein Chatfenster eingefügten Pentester-Prompt: ein Team von Agenten und ein gemeinsamer Speicher.
Das Design folgt dem Strategen-Koordinator-Modell aus der HPTSA-Forschung — eine 4,3-fache Verbesserung gegenüber einem einzelnen Agenten:
┌─────────────┐
│ pentest │ strategist / coordinator
│ (lead) │ plans, dispatches, tracks state
└──────┬──────┘
┌───────┬───────┼───────┬───────┐
▼ ▼ ▼ ▼ ▼
┌──────┐┌──────┐┌──────┐┌──────┐┌──────┐
│recon ││scan- ││explo-││iden- ││post- │
│ ││ner ││iter ││tity ││explo │ ... + 7 more
└──────┘└──────┘└──────┘└──────┘└──────┘
Der Lead-Agent (pentest) zerlegt den Auftrag in Aufgaben und entsendet Spezialisten-Subagenten parallel — jeder mit eigenem System-Prompt, eigenen Tool-Berechtigungen und eigenem Domänenwissen. Insgesamt 13 Agenten: Recon, Scanner, Enumerator, Exploiter, Identity (AD/Kerberos), Infrastructure (SNMP/IPMI/Datenbanken), Webapp (OWASP Top 10), Post-Exploit, Exploit-Dev, Critic (False-Positive-Prüfer), Reporter, plus versteckte Agenten für Kontextkompression und Session-Management.
Wenn der Scanner einen Port findet, sieht ihn der Enumerator sofort — weil jeder Agent aus einem einzigen strukturierten Engagement-State liest und in ihn schreibt:
Der State überlebt die Session: Terminal schließen, morgen wiederkommen, und der Agent setzt dort fort, wo er aufgehört hat. Daneben protokolliert ein menschenlesbares findings.md jede Schwachstelle, jeden Zugangsdatensatz und jeden Zugriffsgewinn mit Zeitstempeln — mit tail -f lässt sich verfolgen, wie sich der Auftrag entfaltet.
18 integrierte Pentest-Tools jenseits von bash. Parser-Tools sind verpflichtend: Nach dem Ausführen von nmap muss der Agent die Ausgabe durch nmap_parse leiten, statt das XML von Hand zu grepen, damit jeder Fund den Engagement-State erreicht.