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।

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, साथ ही कॉन्टेक्स्ट कम्प्रेशन और सत्र प्रबंधन के लिए छिपे हुए एजेंट।

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

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

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

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

टूल

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

स्किल्स

19 क्यूरेटेड ज्ञान पैक, जो आवश्यकता पर लोड होते हैं ताकि वे केवल प्रासंगिक होने पर ही कॉन्टेक्स्ट खर्च करें:

• चरण चेकलिस्ट (6) — हर पेंटेस्ट चरण में क्या करना है
• सेवा ज्ञान (9) — SMB, SSH, FTP, DNS, डेटाबेस, वेब सर्वर, मेल, Docker/K8s, CI/CD
• प्लेबुक (4) — इंफ्रास्ट्रक्चर, Active Directory, वेब एप्लिकेशन, क्लाउड

स्किल्स सादा मार्कडाउन हैं। अपनी खुद की स्किल जोड़ने के लिए स्किल्स डायरेक्टरी में SKILL.md रखें — कोई कोड बदलाव आवश्यक नहीं।

कमांड और मोड

स्लैश कमांड के साथ लाइव सत्र चलाएँ:

और तय करें कि एजेंट को कितनी छूट मिले:

• auto — पेंटेस्ट चरणों से स्वायत्त रूप से गुजरता है, आवश्यकता अनुसार सबएजेंट उत्पन्न करता है
• free — कोई चरण संरचना नहीं; आपके अनुरोधों का सीधे जवाब देता है (स्कोप जाँच को बायपास करता है)
• guided — चरण दर चरण; हर कार्रवाई का प्रस्ताव करता है और अनुमोदन की प्रतीक्षा करता है

मोड पॉज़ व्यवहार के साथ संयुक्त होते हैं — auto + pause always आपको स्वायत्त निष्पादन देता है जो समीक्षा के लिए हर खोज पर रुकता है।

उपयोग के मामले

आक्रामक सुरक्षा में एक टूलकिट:

• पैठ परीक्षण — recon से रिपोर्टिंग तक पूर्ण पद्धति
• CTF प्रतियोगिताएँ — फ्लैग ट्रैकिंग, उद्देश्य प्रबंधन, मल्टी-टार्गेट समन्वय
• बग बाउंटी — वेब ऐप परीक्षण, API सुरक्षा, recon स्वचालन
• भेद्यता अनुसंधान — व्यवस्थित एन्यूमरेशन और सत्यापन
• इंफ्रास्ट्रक्चर सुरक्षा — नेटवर्क सेवा ऑडिटिंग, डिफ़ॉल्ट-क्रेडेंशियल जाँच

कॉन्फ़िगरेशन

कॉन्फ़िगरेशन .pentestcode/pentestcode.jsonc में रहता है:

{
  "provider": {
    "anthropic": {
      "model": "claude-sonnet-4-20250514"
    }
  }
}

प्रदाता: Anthropic, OpenAI, Google, Azure, AWS Bedrock, Ollama, Together, Groq, Fireworks, DeepSeek, Mistral, और ai-sdk के माध्यम से और भी।

योगदान

वास्तविक उपयोग से मिलने वाली बग रिपोर्ट सबसे मूल्यवान चीज़ है जो आप भेज सकते हैं। PentestCode को CTF बॉक्स, HTB मशीन, या अधिकृत पेंटेस्ट पर चलाएँ, और जब कुछ गलत होता है — यह लूप करता है, स्पष्ट पथ चूक जाता है, टूल आउटपुट पर अटक जाता है, या टोकन बर्बाद करता है — तो इस जानकारी के साथ इश्यू खोलें:

1. आप क्या परीक्षण कर रहे थे (लक्ष्य प्रकार, संवेदनशील विवरण नहीं)
2. क्या गलत हुआ
3. findings.md और/या प्रासंगिक सत्र आउटपुट

फीचर अनुरोध और PR भी स्वागत योग्य हैं। कोडबेस Effect लाइब्रेरी पर TypeScript है — आर्किटेक्चर के लिए CLAUDE.md देखें।

लाइसेंस

MIT — LICENSE देखें।

OpenCode का हार्ड फोर्क • आक्रामक सुरक्षा के लिए बनाया गया • सेल्फ-होस्टेड और ओपन सोर्स