PentestCode

आपके टर्मिनल में AI पेनिट्रेशन टेस्टिंग एजेंट।
मल्टी-एजेंट आर्किटेक्चर • एंगेजमेंट स्टेट ट्रैकिंग • 20+ LLM प्रोवाइडर

PentestCode आपके टर्मिनल के लिए एक स्वायत्त पेनटेस्टिंग एजेंट है। इसे किसी टारगेट पर इंगित करें और यह टूल्स चलाता है, आउटपुट पढ़ता है, नेटवर्क की अपनी तस्वीर अपडेट करता है, और तय करता है कि आगे क्या करना है — ठीक वैसे जैसे एक ऑपरेटर करता है। यह OpenCode (MIT) का एक हार्ड फोर्क है, जिसे कोड-एडिटिंग फोकस से हटाकर ऑफेंसिव सिक्योरिटी के लिए फिर से बनाया गया है।

बीटा — यह वास्तविक एंगेजमेंट और CTF पर टिकता है, लेकिन कुछ खुरदुरे किनारों की अपेक्षा करें। जब कुछ टूटे तो एक इश्यू फाइल करें; यही इसे बेहतर बनाता है।

यह क्या करता है

एक निर्देश अंदर, पूरी अटैक चेन बाहर:

you: "pentest 10.10.10.5, goal is domain admin"

यह वहां व्यवस्थित है जहां लोग आलसी हो जाते हैं: यह हर क्रेडेंशियल को हर होस्ट पर हर सर्विस के खिलाफ स्प्रे करता है, और चीज़ों की जांच करना नहीं भूलता। जो कुछ भी यह सीखता है वह एक संरचित स्टेट में जाता है जिसे आप रन के दौरान /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 रिसर्च के स्ट्रैटेजिस्ट-कोऑर्डिनेटर मॉडल का अनुसरण करता है — एकल एजेंट की तुलना में 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 (फॉल्स-पॉज़िटिव चेकर), reporter, साथ ही कॉन्टेक्स्ट कम्प्रेशन और सेशन मैनेजमेंट के लिए छिपे हुए एजेंट।

एक मेमोरी जो वे सभी साझा करते हैं

जब स्कैनर कोई पोर्ट ढूंढता है, तो एन्यूमरेटर उसे तुरंत देख लेता है — क्योंकि हर एजेंट एक संरचित एंगेजमेंट स्टेट से पढ़ता और उसमें लिखता है:

• होस्ट और सर्विसेज़ — IP, होस्टनेम, OS, पोर्ट, सर्विस वर्शन, बैनर
• कमजोरियां — गंभीरता, स्टेटस (संदिग्ध / पुष्ट / शोषित), एविडेंस चेन, कॉन्फिडेंस स्कोर
• क्रेडेंशियल्स — यूज़रनेम, हैश/पासवर्ड, प्रकार, डोमेन, वे क्या अनलॉक करते हैं
• एक्सेस — कौन किस होस्ट पर शेल/RDP/DB रखता है, किस विशेषाधिकार स्तर पर
• रिलेशनशिप — एक एंटिटी ग्राफ (EXPLOITED_VIA, CREDENTIAL_FROM, ADMIN_OF, PIVOT_TO, …)
• AD डोमेन मॉडल — डोमेन कंट्रोलर, ट्रस्ट, एडमिन, पासवर्ड पॉलिसी, GPO
• नेटवर्क सेगमेंट — VLAN, पहुंचने योग्य नेटवर्क, पिवट होस्ट
• अटैक पाथ — रिलेशनशिप ग्राफ के माध्यम से कॉस्ट-आधारित Dijkstra + Yen's K-shortest रूट

स्टेट सेशन से आगे भी बची रहती है: टर्मिनल बंद करें, कल वापस आएं, और एजेंट वहीं से फिर शुरू करता है जहां उसने छोड़ा था। इसके साथ, एक मानव-पठनीय findings.md हर कमजोरी, क्रेडेंशियल, और एक्सेस गेन को टाइमस्टैम्प के साथ लॉग करता है — एंगेजमेंट को होते हुए देखने के लिए इसे tail -f करें।

टूल्स

bash के अलावा 18 बिल्ट-इन पेंटेस्ट टूल्स। पार्सर टूल्स अनिवार्य हैं: nmap चलाने के बाद एजेंट को आउटपुट को nmap_parse के माध्यम से पाइप करना चाहिए, न कि XML को हाथ से grep करना, ताकि हर फाइंडिंग एंगेजमेंट स्टेट तक पहुंचे।

स्किल्स

19 क्यूरेटेड नॉलेज पैक, मांग पर लोड होते हैं ताकि वे कॉन्टेक्स्ट की कीमत केवल तभी चुकाएं जब प्रासंगिक हों: