
स्वायत्त AI पैठ परीक्षण एजेंट जो स्थायी इंगेजमेंट स्थिति के साथ बहु-एजेंट टोही, शोषण, पोस्ट-एक्सप्लॉइटेशन और रिपोर्टिंग का समन्वय करता है।
आपके टर्मिनल में AI पेनेट्रेशन टेस्टिंग एजेंट।
मल्टी-एजेंट आर्किटेक्चर • एंगेजमेंट स्टेट ट्रैकिंग • 20+ LLM प्रोवाइडर
PentestCode आपके टर्मिनल के लिए एक स्वायत्त पेनेट्रेशन टेस्टिंग एजेंट है। इसे किसी लक्ष्य पर इंगित करें और यह टूल्स चलाता है, आउटपुट पढ़ता है, नेटवर्क की अपनी समझ को अपडेट करता है, और तय करता है कि आगे क्या करना है — ठीक वैसे ही जैसे कोई ऑपरेटर करता। यह OpenCode (MIT) का एक हार्ड फोर्क है, जिसे कोड-एडिटिंग केंद्रितता से मुक्त करके ऑफेंसिव सिक्योरिटी के लिए फिर से बनाया गया है।
बीटा — यह वास्तविक एंगेजमेंट्स और CTFs पर टिकता है, लेकिन खुरदुरे किनारों की अपेक्षा करें। जब कुछ टूटे तो एक इश्यू फाइल करें; यही इसे बेहतर बनाता है।
एक निर्देश अंदर, पूरी अटैक चेन बाहर:
you: "pentest 10.10.10.5, goal is domain admin"
| चरण | एजेंट क्या करता है |
|---|---|
| स्कैन | nmap -sS -p- 7 खुले पोर्ट ढूँढता है और XML को सीधे engagement state में पार्स करता है |
| पहचान | पोर्ट 88 + 389 → Domain Controller। समानांतर में तीन enumerators को फैलाता है (SMB, LDAP, HTTP) |
| गणना | Null SMB session → writable share। LDAP → उपयोगकर्ता सूची। Gobuster → web dirs |
| हमला | AS-REP roast → crackable hash → पहला वैध क्रेडेंशियल |
| स्प्रे | वह क्रेडेंशियल हर ज्ञात होस्ट पर SMB, WinRM, LDAP और RDP में स्प्रे किया जाता है |
| शोषण | WinRM foothold → post-exploit एजेंट SAM / LSA / DPAPI डंप करता है |
| परिणाम | Domain admin hash हाथ में — हर चरण अपनी evidence chain के साथ दर्ज |
यह वहाँ व्यवस्थित है जहाँ लोग आलसी हो जाते हैं: यह हर होस्ट पर हर सेवा के विरुद्ध हर क्रेडेंशियल स्प्रे करता है, और चीज़ों की जाँच करना नहीं भूलता। जो कुछ भी यह सीखता है वह एक संरचित state में जमा होता है जिसे आप रन के बीच में /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
ai-sdk के माध्यम से 20+ प्रदाताओं के साथ काम करता है — Anthropic, OpenAI, Google, Azure, AWS Bedrock, Ollama, और अन्य।
PentestCode को चैट विंडो में पेस्ट किए गए पेंटेस्टर प्रॉम्प्ट से दो चीज़ें अलग करती हैं: एजेंटों की एक टीम और एक साझा मेमोरी।
यह डिज़ाइन HPTSA research के रणनीतिकार-समन्वयक मॉडल का अनुसरण करता है — जो एकल एजेंट की तुलना में 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/databases), webapp (OWASP Top 10), post-exploit, exploit-dev, critic (false-positive checker), reporter, साथ ही context compression और session management के लिए छिपे हुए एजेंट।
जब scanner कोई पोर्ट ढूँढता है, तो enumerator उसे तुरंत देख लेता है — क्योंकि प्रत्येक एजेंट एक संरचित engagement state से पढ़ता और उसमें लिखता है:
State सत्र से आगे भी बनी रहती है: टर्मिनल बंद करें, कल वापस आएँ, और एजेंट वहीं से फिर शुरू करता है जहाँ उसने रोका था। इसके साथ, एक मानव-पठनीय findings.md प्रत्येक vulnerability, credential और access gain को timestamps के साथ लॉग करता है — एंगेजमेंट को होते हुए देखने के लिए इसे tail -f करें।
bash के अलावा 18 अंतर्निहित pentest टूल्स। Parser टूल्स अनिवार्य हैं: nmap चलाने के बाद एजेंट को XML को हाथ से grep करने के बजाय आउटपुट को nmap_parse के माध्यम से पाइप करना होता है, ताकि प्रत्येक finding engagement state तक पहुँचे।
| टूल | यह क्या करता है |
|---|---|
nmap_parse | nmap XML पार्स करें → hosts/services स्वतः भरें |
nuclei_parse | Nuclei JSON पार्स करें → severity के साथ vulns बनाएँ |
cme_parse | NetExec आउटपुट पार्स करें → creds/access/hosts अपडेट करें |
gobuster_parse | dir brute आउटपुट पार्स करें → findings वर्गीकृत करें |
bloodhound_parse | SharpHound JSON पार्स करें → AD model भरें |
sqlmap_parse | sqlmap आउटपुट पार्स करें → injection points निकालें |
xss_detect | reflected/stored XSS के लिए responses का विश्लेषण करें |
jwt_analyze | JWT डिकोड करें, alg:none/weak HMAC/expiry जाँचें |
cred_spray | सभी खोजी गई services पर credential spray की योजना बनाएँ |
scope_check | CIDR/wildcard scope सत्यापन |
attack_path_suggest | relationship graph के माध्यम से cost-based path finding |
tunnel_manage | SSH/chisel/ligolo tunnels की योजना बनाएँ, live sessions ट्रैक करें |
phase_control | quality gates के साथ phase प्रबंधन |
report_gen | markdown/JSON pentest रिपोर्ट जनरेट करें |
state_update | findings रिकॉर्ड करें (30+ mutation types, batch mode) |
state_query | engagement state क्वेरी करें (20+ query types) |
19 क्यूरेटेड ज्ञान पैक, माँग पर लोड होते हैं ताकि वे context की लागत केवल तभी लें जब प्रासंगिक हों: