Skill, curl, और git-clone विकल्पों, साथ ही PEP 668 सिस्टम और secret-cloaking सेटअप के लिए, [पूर्ण इंस्टॉलेशन गाइड](https://github.com/prismorsec/prismor/blob/main/docs/installation.md) देखें।

---

## क्षमताएँ<a name="capabilities" />

![Prismor Architecture](https://assets.kitploit.com/production/public/readmes/13903/0e84c7211b3275de581182b7f69c44d8224142323b43220dd1234eee17616757.png)

- 🛡️ [Prismor](https://github.com/prismorsec/prismor/blob/main/docs/prismor-runtime.md) में policy engine, session logs, security audit, और CLI reference शामिल हैं
- 📦 [Supply Chain](https://github.com/prismorsec/prismor/blob/main/docs/supply-chain.md) में install-time enforcement, IOC matching, और risk scoring शामिल हैं
- 🛜 [Network Isolation](https://github.com/prismorsec/prismor/blob/main/docs/network-isolation.md) में policy-driven egress control, raw IP detection, और tunnel blocking शामिल हैं
- 🔍 [Skill Scanner](https://github.com/prismorsec/prismor/blob/main/docs/skill-scanner.md) समर्थित agents में MCP server और skill risk scanning को कवर करता है
- 🚦 [MCP Guardrails](https://github.com/prismorsec/prismor/blob/main/docs/prismor-runtime.md#custom-guardrails-for-mcp-tools) आपको किसी विशिष्ट MCP server या tool को ब्लॉक करने, या agent द्वारा उसे कॉल करने से पहले मानवीय अनुमोदन की आवश्यकता रखने की सुविधा देते हैं, आपके द्वारा लिखे गए policy rule के साथ
- 🛰️ [MCP Gateway](https://github.com/prismorsec/prismor/blob/main/docs/mcp-gateway.md) एक एकल MCP connector है जो आपके द्वारा उपयोग किए जाने वाले हर अन्य MCP server के सामने होता है — प्रत्येक `tools/call` को forward करने से पहले policy-evaluated किया जाता है और प्रत्येक response को model देखने से पहले injection-scanned किया जाता है, इसलिए एक poisoned tool result कभी context नहीं बनता। `prismor mcp-gateway install` एक मौजूदा `.mcp.json` को इसके पीछे ले जाता है
- 🛤️ [LLM Proxy](https://github.com/prismorsec/prismor/blob/main/docs/llm-proxy.md) उस agent को नियंत्रित करता है जिसे Prismor hook नहीं कर सकता, उस एक चीज़ के माध्यम से जो हर agent के पास होती है: उसका model traffic। इसे `ANTHROPIC_BASE_URL`, `OPENAI_BASE_URL`, या Google Gen AI SDK के `HttpOptions(base_url=...)` के साथ `prismor proxy` पर इंगित करें और agent के बारे में और कुछ नहीं बदलता। model द्वारा *प्रस्तावित* प्रत्येक tool call — Anthropic `tool_use`, OpenAI `tool_calls`, Gemini `functionCall` — को उसी event में बदल दिया जाता है जो एक `Bash` hook उत्पन्न करता है और उसी rule द्वारा निर्णित किया जाता है, streamed calls को तब तक रोका जाता है जब तक उन्हें निर्णित नहीं किया जा सकता
- [Claude Inference Hooks](https://github.com/prismorsec/prismor/blob/main/docs/inference-hook.md) Prismor को Claude Enterprise के पीछे AI security server बनाता है: Anthropic claude.ai, Claude Code और Cowork से प्रत्येक governed prompt को `prismor inference-hook serve` पर भेजता है, जो transcript पर आपकी policy चलाता है और model चलने से पहले allow/deny का उत्तर देता है — signed requests (Standard Webhooks), fail-closed, shadow mode, उपयोगकर्ता उपकरणों पर कुछ भी इंस्टॉल करने की आवश्यकता नहीं। `prismor inference-hook test` wiring की जाँच के लिए signed sample frames भेजता है
- 🏷️ [Tool Tags](https://github.com/prismorsec/prismor/blob/main/docs/tool-tags.md) tools को capability (read, write, network, exec) के आधार पर वर्गीकृत करते हैं ताकि एक rule कह सके "जो कुछ भी private data पढ़ता है वह network तक भी न पहुँचे" बजाय हर tool का एक-एक करके नाम लेने के — MCP tools `_meta` के माध्यम से स्वयं घोषित करते हैं, और `prismor tags` rule expressions को सूचीबद्ध, परीक्षण और lint करता है
- 🔐 [Sweep and Cloak](https://github.com/prismorsec/prismor/blob/main/docs/sweep-and-cloak.md) tool boundaries पर secret prevention, व्यावहारिक सेटअप, सर्वोत्तम प्रथाएँ, threat model, और leaked secrets की cleanup को कवर करता है
- 🦞 [OpenClaw Integration](https://github.com/prismorsec/prismor/blob/main/docs/openclaw.md) OpenClaw के लिए runtime hooks, prompt-injection scanning, और project या user-scope सेटअप को कवर करता है
- 🤖 [Hermes Agent Cloaking](https://github.com/prismorsec/prismor/blob/main/docs/hermes.md) pip entry-point auto-discovery, filesystem install, और pre_gateway_dispatch paste guard के साथ Hermes-विशिष्ट secret cloaking को कवर करता है
- ☁️ [Hosted Agent VMs](https://github.com/prismorsec/prismor/blob/main/docs/cloud-agents.md) उन agents को नियंत्रित करता है जो ऐसी मशीन पर चलते हैं जिसमें आप कभी लॉग इन नहीं करते (Claude Code on the web, Cursor cloud agents, Copilot coding agent, OpenHands Cloud, Codex cloud, Replicas): platform का setup script binary इंस्टॉल करता है, और `install-hooks --portable` एक hook config लिखता है जिसे commit करना सुरक्षित है
- 🧠 [Semantic Guard](https://github.com/prismorsec/prismor/blob/main/docs/semantic-guard.md): opt-in hybrid layer जो paraphrased prompt-injection प्रयासों के लिए LLM-assisted intent check जोड़ता है जिन्हें regex rules पकड़ नहीं सकते
- 🪤 [Canary](https://github.com/prismorsec/prismor/blob/main/docs/canary.md) honeytoken credential files लगाता है जो agent द्वारा उन्हें पढ़ने के क्षण ही एक CRITICAL finding trigger करते हैं, recon व्यवहार को पकड़ते हुए
- 🪪 [IAM](https://github.com/prismorsec/prismor/blob/main/docs/iam.md) प्रत्येक agent को एक नामित पहचान और least-privilege permission profile देता है जब कई agents एक workspace साझा करते हैं
- 🧩 [Framework Agents](https://github.com/prismorsec/prismor/blob/main/docs/frameworks-overview.md) production agents (OpenAI Agents SDK, LangChain/LangGraph in Python and JS, CrewAI, browser-use, Pydantic AI, AutoGen Core, Agno, Semantic Kernel, Google ADK, BeeAI, Claude Agent SDK, Vercel AI SDK, Mastra) को एक call से सुरक्षित करता है — प्रत्येक request को `use_subject("user:alice")` में wrap करें और एक multi-tenant agent को per-user attribution, per-user IAM profiles, और per-user suspension मिलता है
- 🎯 [Scoped Agent](https://github.com/prismorsec/prismor/blob/main/docs/scoped-agent.md) प्रति session न्यूनतम, task-specific rules संश्लेषित करता है ताकि एक injected pivot off-task ब्लॉक हो जाए
- 🧬 [Learning](https://github.com/prismorsec/prismor/blob/main/docs/learning.md) session history को mine करके नए rules प्रस्तावित करता है, false positives को चिह्नित करता है, और evasion का पता लगाता है
- ⚖️ [Layered Policy & Exemptions](https://github.com/prismorsec/prismor/blob/main/docs/policy-layers-and-exemptions.md) per-rule observe/enforce, non-overridable floor, और org / project / repo layers में admin-granted, time-boxed exemptions को कवर करता है
- 🔐 [Explicit enforce selection & the unlock window](https://github.com/prismorsec/prismor/blob/main/docs/cli-reference.md#choosing-what-blocks) — enforce setup कुछ भी ब्लॉक किए बिना शुरू होता है और आप सेट चुनते हैं; `prismor allow` संकीर्ण अपवाद बनाता है, और `prismor unlock` एक password-gated, time-boxed window खोलता है जिसमें एक agent policy संपादित कर सकता है (कभी भी उन self-protection rules को नहीं जो Prismor की ही रक्षा करते हैं)
- 📡 [Live Telemetry](https://github.com/prismorsec/prismor/blob/main/docs/live-telemetry.md) वैकल्पिक enterprise control-plane link को कवर करता है — device enrollment, signed remote policy, और self-hosted org dashboard पर streamed redacted telemetry
- 🔌 [Telemetry Sinks](https://github.com/prismorsec/prismor/blob/main/docs/telemetry-sinks.md) प्रत्येक finding को उसी चीज़ पर forward करता है जो आप पहले से चलाते हैं — एक OpenTelemetry collector (OTLP/HTTP logs), Splunk HEC, Datadog, syslog, एक webhook, या JSON/CEF/OCSF में एक local file — blocking decision से पहले dispatched और कभी भी tool call को stall नहीं कर सकता
- 📊 [Dashboard](https://github.com/prismorsec/prismor/blob/main/docs/dashboard.md) terminal और local web dashboards के साथ-साथ session forensics को कवर करता है, जिसमें `prismor tokens` बताता है कि एक session का context और token spend वास्तव में कहाँ गया
- 🩺 [Health and Recovery](https://github.com/prismorsec/prismor/blob/main/docs/cli-reference.md) — `prismor doctor` प्रत्येक subsystem (hooks, policy signature, enrollment, telemetry sink, chain state) की health-check करता है, और `prismor pause` / `pause-hard` किसी incident के दौरान मानव के लिए *केवल enforcement* को suspend करता है जबकि observe-mode logging चलता रहता है
- 🧾 [Signed Audit Trail](https://github.com/prismorsec/prismor/blob/main/docs/audit-trail.md) प्रत्येक agent action को locally hash-chain और Ed25519-sign करता है, इसलिए `prismor trail verify` सिद्ध करता है कि history को संपादित, हटाया या फिर से लिखा नहीं गया है
- 🔖 [Signed Telemetry Receipts](https://github.com/prismorsec/prismor/blob/main/docs/telemetry-receipts.md) उन records के लिए wire schema है जो एक device रिपोर्ट करता है — canonical bytes, दो integrity layers, और एक dependency-free reference verifier, ताकि एक SIEM या auditor Prismor के बिना एक receipt की जाँच कर सके
- 📑 [Attestation Bundle](https://github.com/prismorsec/prismor/blob/main/docs/attestation-bundle.md) posture, agent inventory, host discovery, framework-control coverage (OWASP LLM/Agentic, NIST AI RMF, EU AI Act), और trail anchor को एक Ed25519-signed file में पैक करता है जिसे एक auditor `prismor attest verify` के साथ पुनः सत्यापित करता है
- 🔦 [Host Discovery](https://github.com/prismorsec/prismor/blob/main/docs/attestation-bundle.md#host-discovery) `prismor discover` के साथ मशीन को sweep करता है और Prismor hooks के बिना चल रहे किसी भी AI agent (shadow AI) को चिह्नित करता है
- ⏪ [Transcript Ingest](https://github.com/prismorsec/prismor/blob/main/docs/transcript-ingest.md) पुनर्निर्माण करता है कि Prismor इंस्टॉल होने से *पहले* आपके agents ने क्या किया — `prismor ingest --discover` on-disk session transcripts को live policy engine के माध्यम से replay करता है, इसलिए dashboard पहले ही दिन populated हो जाता है और आप ठीक-ठीक देख सकते हैं कि किसी rule को enforce में बदलने से क्या ब्लॉक होता, साथ ही unmonitored चले sessions के लिए `--coverage`
- 🗺️ [Agentic AI Architecture Review](https://github.com/prismorsec/prismor/blob/main/docs/agentic-architecture-review.md) multi-agent/tool-using systems के लिए एक design-time checklist है — permission scope, memory integrity, inter-agent trust, human-oversight placement — प्रत्येक item एक वास्तविक control ID से mapped और, जहाँ एक मौजूद है, उस Prismor rule से जो उसका backstop करता है
- 🐳 [Docker and Containers](https://github.com/prismorsec/prismor/blob/main/docs/docker.md) container hardening, prerequisites, और known limitations को कवर करता है

प्रत्येक capability में पूर्ण command map: [CLI Reference](https://github.com/prismorsec/prismor/blob/main/docs/cli-reference.md)।

ये capabilities [OWASP Top 10 for LLM Applications](https://genai.owasp.org/llm-top-10/) से mapped हैं - prompt injection (LLM01), sensitive information disclosure (LLM02), supply chain (LLM03), improper output handling (LLM05), और excessive agency (LLM06) को कवर करते हुए।

---

## परिदृश्य और उपयोग के मामले<a name="scenarios-and-use-cases" />

वास्तविक workflows उन commands और config के साथ जो उन्हें काम कराते हैं — observe mode में एक team को onboarding करना, multi-agent और framework pipelines के लिए per-user IAM attribution, shadow AI discovery, high-stakes operations के लिए step-up approval, और compliance audit के लिए एक signed attestation bundle उत्पन्न करना। [USE_CASES.md](https://github.com/prismorsec/prismor/blob/main/USE_CASES.md) देखें।

---

## कॉन्फ़िगरेशन<a name="configuration" />

### Command Reference

पूर्ण command map: [docs/cli-reference.md](https://github.com/prismorsec/prismor/blob/main/docs/cli-reference.md)।

### Governance Modes

`prismor setup` आपसे छह policy axes को हाथ से कॉन्फ़िगर करने के बजाय एक posture चुनने के लिए कहता है। प्रत्येक `.prismor/policy.yaml` में compile होता है — enforcement, egress, tool access, tag rules, sandbox और data boundary एक साथ।

![Prismor governance modes](https://raw.githubusercontent.com/prismorsec/prismor/main/assets/prismor-modes.png)

| Mode | For | Coverage | Friction |
|---|---|---|---|
| `dev-safe` | उस code पर feature work जिसे आपने पढ़ा नहीं है | 31% | 9% |
| `trusted-workspace` | विश्वसनीय internal repos, local Docker work | 34% | 9% |
| `regulated-airgap` | PII/PHI, SOC 2, EU AI Act — कोई network नहीं, कोई shell नहीं | 100% | 90% |```bash
prismor mode list                            # compare the three
prismor mode explain dev-safe                # the trade, including what it does NOT stop
prismor mode apply dev-safe                  # compile it into this workspace
prismor mode apply regulated-airgap --observe   # what it would block, blocking nothing

### एक नीति इंजन, हर प्रवर्तन सतह

चरण 1 में एक से अधिक द्वार हैं, और यह जानबूझकर है: कोई भी एकल इंटरपोज़िशन
बिंदु हर एजेंट को कवर नहीं करता। हुक्स सबसे व्यापक हैं लेकिन हर होस्ट उन्हें
प्रदान नहीं करता; MCP एकमात्र ऐसा स्थान है जहाँ कुछ एजेंट्स को बिल्कुल भी
इंटरसेप्ट किया जा सकता है; प्रोडक्शन फ्रेमवर्क एजेंट्स वहाँ चलते हैं जहाँ हुक
करने के लिए कोई होस्ट नहीं होता।

इसलिए प्रत्येक सतह जो उसने देखा उसे एक विहित इवेंट में सामान्यीकृत करती है और
निर्णय के लिए उसी मूल्यांकनकर्ता से पूछती है। एक बार लिखा गया नियम उसी क्रिया
को कवर करता है चाहे वह किसी भी तरह से आए।

| सतह | यह क्या नियंत्रित करती है | अस्वीकार | इनपुट पुनर्लेखन | आउटपुट रिडैक्ट |
|---|---|:--:|:--:|:--:|
| कोडिंग-एजेंट हुक्स | एक एजेंट की संपूर्ण टूल सतह | हाँ | Claude/Qwen | नहीं |
| MCP गेटवे | एक कनेक्टर के पीछे हर MCP सर्वर | हाँ | हाँ | हाँ |
| मिरर किए गए बिल्ट-इन्स | एजेंट के स्वयं के Bash/Read/Write, MCP के माध्यम से | हाँ | हाँ | हाँ |
| फ्रेमवर्क SDK अडैप्टर | इन-प्रोसेस एजेंट्स (13 फ्रेमवर्क) | हाँ | नहीं | नहीं |
| `prismor eval-server` | गैर-Python कॉलर, बाहरी प्रॉक्सी | हाँ | हाँ | हाँ |
| इन्फरेंस-हुक चैनल | होस्टेड ट्रांसक्रिप्ट-टर्न वेबहुक | हाँ | नहीं | नहीं |

"आउटपुट रिडैक्ट" ही मिरर के होने का कारण है: एक प्री-एक्शन हुक केवल फ़ाइल
रीड को *अस्वीकार* कर सकता है, जबकि प्रतिक्रिया ले जाने वाली सतह फ़ाइल को
क्रेडेंशियल मास्क करके लौटा सकती है।

यह दावा करने के बजाय जाँचा जाता है — `tests/test_surface_conformance.py`
प्रत्येक सतह के अपने नॉर्मलाइज़र के माध्यम से एक क्रिया को दोबारा चलाता है और
यदि वे निर्णय या नियम पर असहमत होते हैं तो विफल हो जाता है।

इवेंट आकार और निर्णय शब्दावली के लिए [निर्णय अनुबंध](https://github.com/prismorsec/prismor/blob/main/docs/decision-contract.md)
देखें, और प्रति एजेंट किस सतह का उपयोग करना है इसके लिए
[गवर्नेंस सतहें](https://github.com/prismorsec/prismor/blob/main/docs/governance-surfaces.md) देखें।

---

## चयनित क्षमताएँ, विस्तार से<a name="selected-capabilities-walked-through" />

[क्षमताएँ](#capabilities) से तीन मॉड्यूल, सेटअप, आउटपुट और परिणामों के साथ।

### हाइब्रिड सिमेंटिक प्रॉम्प्ट-इंजेक्शन डिफेंस<a name="hybrid-semantic-prompt-injection-defense" />

Regex नियम ज्ञात इंजेक्शन आकृतियों को पकड़ते हैं। सिमेंटिक गार्ड एक इंटेंट-जागरूक
परत जोड़ता है: एक ह्यूरिस्टिक प्री-स्क्रीन स्पष्ट मामलों को <1 ms में संभालता है,
और अनिश्चित इनपुट एक LLM जज तक बढ़ते हैं जो किसी भी स्थिति में निर्णय का स्वामी
होता है — यह उन पराफ्रेज़्ड हमलों की पुष्टि करता है जिन्हें regex ने केवल आधा देखा
था और उस बेनाइन टेक्स्ट को साफ़ करता है जिसने ऑथोरिटी-क्लेम सिग्नल को ट्रिगर
किया था। 800+ मामलों में परीक्षण किया गया — **+30% रिकॉल** बिना किसी अतिरिक्त
फ़ॉल्स पॉज़िटिव के, जिसमें पराफ्रेज़्ड और इन-फ़ाइल इंजेक्शन शामिल हैं जो regex को
बायपास करते हैं।

![Semantic Guard Results](https://assets.kitploit.com/production/public/readmes/13903/a32297d3549c5ff60690c8dca14490f1d53a17a253d912bcb2187414dea3d018.png)

जज उस लॉगिन पर चलता है जो आपके पास पहले से है — किसी API key की आवश्यकता नहीं।
`prismor setup` अपने **LLM judge** चरण पर पूछता है; स्क्रिप्टेड:```bash
prismor setup --non-interactive --judge claude   # Claude Code CLI, your Claude login
prismor setup --non-interactive --judge codex    # Codex CLI, your ChatGPT login
prismor setup --non-interactive --judge api --judge-model gpt-4o-mini   # any litellm model + key

pip install requests

python3 poc.py --target http://target-host:3000 --payload "your-payload-here"

python3 poc.py --target http://localhost:3000 --command "id"

निर्णय: `< 30` अनुमति · `30–59` चेतावनी · `≥ 60` अवरोध। IOC मिलान हमेशा अवरोध करता है। हर इंस्टॉल को स्वचालित रूप से गेट करने के लिए अपने पैकेज मैनेजरों को अलियास करें।

`prismor supplychain harden` लॉकडाउन सेटिंग्स को `.npmrc` / `.yarnrc.yml` / `pip.conf` / `.cargo/config.toml` में लिखता है ताकि पैकेज मैनेजर उन्हें लागू करे, भले ही अलियास को बायपास किया गया हो (CI, IDE प्लगइन्स)।```bash
prismor supplychain harden           # apply to current directory
prismor supplychain harden --dry-run

`--scope` का डिफ़ॉल्ट `project` है। **Project और user scope अलग-अलग फ़ाइलें संपादित करते हैं** — केवल `--scope user` चलाने से किसी workspace के local hooks *नहीं* छूते, और इसके विपरीत भी:

| Agent | Project scope | User scope |
|---|---|---|
| Claude Code | `<workspace>/.claude/settings.json` | `~/.claude/settings.json` |
| Cursor | `<workspace>/.cursor/hooks.json` | `~/.cursor/hooks.json` |
| Windsurf | `<workspace>/.windsurf/hooks.json` | `~/.codeium/windsurf/hooks.json` |
| OpenClaw | `<workspace>/.openclaw/plugins.json` | `~/.openclaw/config.json` |
| Hermes | `<workspace>/.hermes/plugins.json` | `~/.hermes/config.json` |
| Codex | `<workspace>/.codex/hooks.json` | `~/.codex/hooks.json` |
| Copilot | `<workspace>/.github/copilot/hooks.json` | `~/.copilot/hooks.json` |
| Grok Build | `<workspace>/.grok/hooks/prismor.json` | `~/.grok/hooks/prismor.json` |
| Kiro CLI | `<workspace>/.kiro/agents/kiro_default.json` | `~/.kiro/agents/kiro_default.json` |
| Crush | `<workspace>/crush.json` | `~/.config/crush/crush.json` |
| OpenHands | `<workspace>/.openhands/hooks.json` | `~/.openhands/hooks.json` |
| Qwen Code | `<workspace>/.qwen/settings.json` | `~/.qwen/settings.json` |
| Continue CLI | `<workspace>/.continue/settings.json` | `~/.continue/settings.json` |
| Goose | `<workspace>/.agents/plugins/prismor/hooks/hooks.json` | `~/.agents/plugins/prismor/hooks/hooks.json` |

यदि आप केवल एक scope चलाते हैं, तो दूसरे के hooks (यदि इंस्टॉल हैं) चलते रहेंगे। यदि आप किसी agent के लिए Prismor को पूरी तरह हटाना चाहते हैं, तो दोनों चलाएँ।

एक चल रहे session ने पहले ही अपना hook config लोड कर लिया है — session के बीच में uninstall करने से तब तक प्रभाव नहीं पड़ेगा जब तक आप नया session शुरू नहीं करते।

यदि `prismor uninstall-hooks` सफलता रिपोर्ट करता है लेकिन hooks अभी भी चल रहे हैं, तो संभवतः आप एक पुराना install चला रहे हैं — जैसे कि `pipx`-इंस्टॉल किया गया एक copy जो dev checkout का पुराना snapshot है। `which immunity` जाँचें और, यदि यह किसी `pipx` venv में resolve होता है, तो uninstall दोबारा चलाने से पहले वर्तमान source से पुनः इंस्टॉल करें (`pipx install --force <path-or-package>`)। अंतिम उपाय के रूप में, hooks config फ़ाइल को सीधे हाथ से संपादित करें।

### 2. Soft-disable: observe mode + dry-run

Hooks इंस्टॉल रखें लेकिन उन्हें ब्लॉक करने से रोकें:```bash
prismor install-hooks --agent all --scope project --mode observe
PRISMOR_LOCAL_DRY_RUN=1   # set in your shell/session env