iulianvostrut/contexthoundस्टेटिक विश्लेषण CLI जो कोडबेस को LLM प्रॉम्प्ट-इंजेक्शन, डेटा एक्सफ़िल्ट्रेशन, जेलब्रेक तथा असुरक्षित एजेंट/टूल कमज़ोरियों के लिए स्कैन करता है। पूरी तरह ऑफ़लाइन चलता है, CI/CD के साथ एकीकृत होता है, और कंसोल, JSON तथा SARIF रिपोर्ट आउटपुट करता है।
स्टैटिक विश्लेषण उपकरण जो आपके कोडबेस को LLM प्रॉम्प्ट-इंजेक्शन और मल्टीमॉडल सुरक्षा कमज़ोरियों के लिए स्कैन करता है। ऑफ़लाइन चलता है, किसी API कॉल की आवश्यकता नहीं।
ContextHound आपके पूरे डेवलपमेंट और ब्राउज़िंग वर्कफ़्लो में उपलब्ध है:
| उपकरण | यह क्या करता है | इंस्टॉल |
|---|---|---|
| CLI / npm पैकेज | आपके कोडबेस को प्रॉम्प्ट इंजेक्शन कमज़ोरियों के लिए स्कैन करता है। GitHub Actions के साथ एकीकृत होता है, SARIF, JSON, HTML और अधिक आउटपुट करता है। | npm install -g context-hound |
| VS Code एक्सटेंशन | कोड करते समय इनलाइन निष्कर्ष, कोड एक्शन, आउटपुट चैनल, स्टेटस बार। | VS Code Marketplace |
| ब्राउज़र एक्सटेंशन | किसी भी AI चैट इंटरफ़ेस पर रीयल-टाइम स्कैन पिल, LLM API ट्रैफ़िक के लिए DevTools पैनल, पॉपअप स्कैनर। Chrome और Firefox। | Firefox: मुफ़्त इंस्टॉल करें · Chrome: समीक्षा प्रतीक्षित · सोर्स |
जैसे-जैसे LLM-संचालित एप्लिकेशन प्रोडक्शन कोडबेस में सामान्य हो रहे हैं, प्रॉम्प्ट इंजेक्शन सबसे अधिक शोषण योग्य हमला सतहों में से एक के रूप में उभरा है; अधिकांश सुरक्षा स्कैनर इसके प्रति कोई जागरूकता नहीं रखते।
ContextHound आपकी प्रॉम्प्ट परत पर स्टैटिक विश्लेषण लाता है:
यह आपके मौजूदा वर्कफ़्लो में एक CLI कमांड, एक npm स्क्रिप्ट, एक pre-commit हुक या एक GitHub Action के रूप में फिट होता है। यह कोई नेटवर्क कॉल नहीं करता और इसमें चार छोटी रनटाइम निर्भरताएँ हैं।
| 122 सुरक्षा नियम | 15 परिवारों में: इंजेक्शन, एक्सफ़िल्ट्रेशन, जेलब्रेक, असुरक्षित टूल उपयोग, कमांड इंजेक्शन, RAG पॉइज़निंग, एन्कोडिंग और छिपी सामग्री, आउटपुट हैंडलिंग, मल्टीमॉडल, एजेंट स्किल्स, एजेंटिक, MCP, सप्लाई चेन, संसाधन खपत, पर्सिस्टेंस |
| OWASP मैपिंग | प्रत्येक नियम में OWASP Top 10 for LLM Applications (2025) और Agentic Applications (2026) ID होते हैं, जो hound explain, --verbose, SARIF टैग और सभी रिपोर्ट में दिखाए जाते हैं |
| संख्यात्मक जोखिम स्कोर (0-100) | निम्न, मध्यम, उच्च और क्रिटिकल थ्रेशोल्ड के साथ सामान्यीकृत रेपो-स्तरीय स्कोर |
| शमन पहचान | आपके प्रॉम्प्ट में स्पष्ट सुरक्षा भाषा आपके स्कोर को कम करती है |
| 9 आउटपुट प्रारूप | Console, JSON, SARIF, GitHub Annotations, Markdown, JSONL स्ट्रीमिंग, इंटरैक्टिव HTML, CSV और JUnit XML |
| GitHub Action शामिल | जोखिम भरे परिवर्तनों पर CI विफल करता है, Code Scanning में SARIF अपलोड करता है और पुल रिक्वेस्ट पर सारांश टिप्पणी रख सकता है |
| ऑटोफ़िक्स | hound fix छिपे हुए Unicode वर्णों (ENC-002 से ENC-005) का पूर्वावलोकन करता है और उन्हें हटाता है |
| बहु-भाषा स्कैनिंग | Python, Go, Rust, Java, C#, PHP, Ruby, Swift, Kotlin, Vue और Bash में LLM API उपयोग का पता लगाता है, केवल TypeScript और JavaScript में नहीं |
| नियम फ़िल्टरिंग | प्रीफ़िक्स-ग्लोब सिंटैक्स (CMD-*) के साथ excludeRules/includeRules; minConfidence फ़िल्टर |
| इंक्रीमेंटल कैश | .hound-cache.json पुनः-रन पर अपरिवर्तित फ़ाइलों को छोड़ देता है; अक्षम करने के लिए --no-cache |
.gitignore का सम्मान करता है | git द्वारा अनदेखी की गई फ़ाइलें छोड़ दी जाती हैं; .houndignore उसी सिंटैक्स में बहिष्करण जोड़ता है |
| प्लगइन सिस्टम | कॉन्फ़िग में "plugins": ["./my-rule.js"] के माध्यम से स्थानीय .js फ़ाइलों से कस्टम नियम लोड करें |
| बेसलाइन / डिफ़ मोड | --baseline results.json केवल पूर्व स्कैन से अनुपस्थित निष्कर्षों पर रिपोर्ट करता है और विफल होता है; --diff केवल परिवर्तित फ़ाइलों को स्कैन करता है |
| वॉच मोड | --watch फ़ाइल परिवर्तनों पर पुनः-स्कैन करता है और डेल्टा निष्कर्ष दिखाता है |
| समानांतर स्कैनिंग | समवर्ती फ़ाइल प्रोसेसिंग (--concurrency <n>, डिफ़ॉल्ट 8) |
| पूरी तरह ऑफ़लाइन | कोई API कॉल नहीं और कोई टेलीमेट्री नहीं |
ग्लोबल इंस्टॉल आपके PATH में hound कमांड जोड़ता है:
npm install -g context-hound
प्रति-प्रोजेक्ट इंस्टॉल एक रेपो तक सीमित होता है और npx hound या किसी npm स्क्रिप्ट के माध्यम से चलता है:
npm install --save-dev context-hound
इंस्टॉल किए बिना, npx पैकेज को फ़ेच करके चलाता है:
npx context-hound scan --dir .
# Scaffold a config file
hound init
# Scan your project
hound scan --dir ./my-ai-project
# Or via npm script (scans current directory)
npm run hound
# Verbose output, shows remediations and confidence levels
hound scan --verbose
# Fail the build on any critical finding
hound scan --fail-on critical
# Export JSON and SARIF reports
hound scan --format console,json,sarif --out results
# GitHub Annotations (for CI step summaries)
hound scan --format github-annotations
# Markdown report with findings tables
hound scan --format markdown --out report
# Stream findings as JSONL (one JSON object per line)
hound scan --format jsonl | jq '.severity'
# List all rules
hound scan --list-rules
# Explain a rule (or a rule family by prefix)
hound explain INJ-001
hound explain PST --format json
# Fast PR gate: scan only files changed vs. origin/main
hound scan --diff
# Interactive HTML report (self-contained, open in browser)
hound scan --format html --out report
# Re-scan on file changes
hound scan --watch
# Parallel scanning (default is 8; tune for your machine)
hound scan --concurrency 16
# Disable incremental cache for a clean run
hound scan --no-cache
# Also scan files that git ignores (skipped by default)
hound scan --no-gitignore
# Preview, then remove, hidden Unicode characters flagged by ENC-002 to ENC-005
hound fix
hound fix --write
# Baseline mode: only report findings new since the last saved scan
hound scan --format json --out baseline # save a baseline
hound scan --baseline baseline.json # compare future scans against it
# Load a custom rule from a local plugin file
hound scan # plugin declared in .contexthoundrc.json "plugins" field