s0ld13rr/pentestcodeAgente autonomo di penetration testing basato su intelligenza artificiale che orchestra ricognizione multi-agente, exploitation, post-exploitation e reporting con stato di engagement persistente.
Agente di penetration testing AI nel tuo terminale.
Architettura multi-agente • Tracciamento dello stato dell'engagement • 20+ provider LLM
PentestCode è un agente di penetration testing autonomo per il tuo terminale. Puntalo su un target ed esegue gli strumenti, legge l'output, aggiorna la sua visione della rete e decide cosa fare dopo — proprio come farebbe un operatore. Un hard fork di OpenCode (MIT), privato del focus sull'editing del codice e ricostruito per la sicurezza offensiva.
Beta — tiene botta su engagement reali e CTF, ma aspettati qualche spigolo. Apri una segnalazione quando qualcosa si rompe; è così che migliora.
Un'istruzione in ingresso, una catena d'attacco completa in uscita:
you: "pentest 10.10.10.5, goal is domain admin"
| Fase | Cosa fa l'agente |
|---|---|
| Scansione | nmap -sS -p- trova 7 porte aperte e analizza l'XML direttamente nello stato dell'engagement |
| Riconoscimento | Porte 88 + 389 → Domain Controller. Sguinzaglia tre enumeratori in parallelo (SMB, LDAP, HTTP) |
| Enumerazione | Sessione SMB nulla → condivisione scrivibile. LDAP → lista utenti. Gobuster → directory web |
| Attacco | AS-REP roast → hash decifrabile → prima credenziale valida |
| Spray | Quella credenziale provata su SMB, WinRM, LDAP e RDP su ogni host noto |
| Exploit | Punto d'appoggio WinRM → l'agente post-exploit estrae SAM / LSA / DPAPI |
| Risultato | Hash di admin di dominio in mano — ogni passo registrato con la sua catena di prove |
È metodico dove le persone tendono a essere pigre: prova ogni credenziale su ogni servizio di ogni host e non si dimentica di verificare nulla. Tutto ciò che apprende finisce in uno stato strutturato che puoi interrogare a metà esecuzione con /status, /vulns o /creds.
npm install -g pentestcode-ai
# via curl
curl -fsSL https://raw.githubusercontent.com/s0ld13rr/pentestcode/main/install.sh | bash
Un singolo binario autonomo — niente Bun, Node o runtime da installare. Linux e macOS, x64 e arm64.
Fissa la versione:
PENTESTCODE_VERSION=0.1.7 curl -fsSL https://raw.githubusercontent.com/s0ld13rr/pentestcode/main/install.sh | bash
Directory personalizzata:
PENTESTCODE_INSTALL=/usr/local/bin curl -fsSL https://raw.githubusercontent.com/s0ld13rr/pentestcode/main/install.sh | bash
Dal sorgente:
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
Funziona con oltre 20 provider tramite ai-sdk — Anthropic, OpenAI, Google, Azure, AWS Bedrock, Ollama e altri.
Due cose distinguono PentestCode da un prompt da pentester incollato in una finestra di chat: un team di agenti e una memoria condivisa.
Il design segue il modello stratega-coordinatore della ricerca HPTSA — un miglioramento di 4,3× rispetto a un agente singolo:
┌─────────────┐
│ pentest │ strategist / coordinator
│ (lead) │ plans, dispatches, tracks state
└──────┬──────┘
┌───────┬───────┼───────┬───────┐
▼ ▼ ▼ ▼ ▼
┌──────┐┌──────┐┌──────┐┌──────┐┌──────┐
│recon ││scan- ││explo-││iden- ││post- │
│ ││ner ││iter ││tity ││explo │ ... + 7 more
└──────┘└──────┘└──────┘└──────┘└──────┘
L'agente principale (pentest) suddivide l'engagement in attività e lancia sottoagenti specializzati in parallelo — ciascuno con il proprio system prompt, i propri permessi sugli strumenti e la propria conoscenza di dominio. 13 agenti in tutto: recon, scanner, enumerator, exploiter, identity (AD/Kerberos), infrastructure (SNMP/IPMI/database), webapp (OWASP Top 10), post-exploit, exploit-dev, critic (controllore dei falsi positivi), reporter, più agenti nascosti per la compressione del contesto e la gestione delle sessioni.
Quando lo scanner trova una porta, l'enumerator la vede all'istante — perché ogni agente legge e scrive su un unico stato dell'engagement strutturato:
Lo stato sopravvive alla sessione: chiudi il terminale, torna domani e l'agente riprende da dove si era fermato. Al suo fianco, un findings.md leggibile dall'uomo registra ogni vulnerabilità, credenziale e accesso ottenuto con i relativi timestamp — monitoralo con tail -f per vedere l'engagement svolgersi.
18 strumenti di pentest integrati oltre a bash. Gli strumenti di parsing sono obbligatori: dopo aver eseguito nmap, l'agente deve passare l'output attraverso nmap_parse invece di fare grep manuale sull'XML, così ogni risultato finisce nello stato dell'engagement.