Cover

संवेदनशील मानों को LLM अनुरोधों से बाहर रखें, बिना बातचीत को तोड़े।

स्थापना · त्वरित प्रारंभ · नीतियाँ · निगरानी · Pi / OMP · सुरक्षा

Cover एक स्थानीय गोपनीयता प्रॉक्सी है, जो Codex, Claude Code, Cursor, SDKs और अन्य HTTP-आधारित AI क्लाइंट्स के लिए है। यह बाहर जाने वाले JSON को स्कैन करता है, मेल खाने वाले मानों को स्थानीय रूप से बदलता है, और JSON तथा स्ट्रीमिंग प्रतिक्रियाओं में प्रतिवर्ती प्रतिस्थापनों को पुनर्स्थापित करता है। LLM को संरक्षित मान प्राप्त होते हैं, जबकि एजेंट मूल मानों का उपयोग जारी रख सकता है।

Cover, नीति-संचालित प्रतिस्थापन, नियतात्मक छद्मनाम, परिचालन जाँच, Codex समर्थन और सख्त विफलता प्रबंधन के साथ एक पारदर्शी रिवर्स प्रॉक्सी के रूप में चलता है। इसे स्थानीय, अवलोकन योग्य रहने और यह स्पष्ट रूप से बताने के लिए डिज़ाइन किया गया है कि यह क्या निरीक्षण नहीं कर सकता।

flowchart LR
    A["Agent"] -->|"JSON request"| C["Cover<br/>detect · transform · enforce"]
    C -->|"protected request"| L["LLM or router"]
    L -->|"JSON or SSE response"| C
    C -->|"restored response"| A

मुख्य विशेषताएँ

स्थापना

इंस्टॉलर Cover को क्लोन करता है, इसे Go के साथ बिल्ड करता है, इसे ~/.local/bin/cover में स्थापित करता है, चयनित क्लाइंट्स को कॉन्फ़िगर करता है, और प्रॉक्सी शुरू करता है।

curl -fsSL https://raw.githubusercontent.com/DavidCarliez/cover/main/scripts/install.sh | bash

आवश्यकताएँ: git और go.mod में घोषित Go संस्करण।

पूर्व-निर्मित Linux, macOS और Windows आर्काइव तथा उनके चेकसम GitHub Releases से उपलब्ध हैं।

गैर-इंटरैक्टिव स्थापना के लिए:

COVER_AGENTS=openai,claude \
  curl -fsSL https://raw.githubusercontent.com/DavidCarliez/cover/main/scripts/install.sh | bash

git clone https://github.com/DavidCarliez/cover.git
cd cover
go build -o cover ./cmd/cover
install -m 0755 cover ~/.local/bin/cover

GOOS=linux GOARCH=arm64 go build -o cover-linux-arm64 ./cmd/cover
GOOS=windows GOARCH=amd64 go build -o cover.exe ./cmd/cover

त्वरित प्रारंभ

cover init             # write ~/.config/cover/config.yaml
cover start --detach   # run in the background
cover doctor           # verify the local setup
cover test             # local redaction round trip, no network call
cover monitor          # watch privacy-safe request metadata

cover init OpenAI, Anthropic या कस्टम अपस्ट्रीम के लिए पूछता है। पूर्ण कॉन्फ़िगरेशन configs/config.example.yaml में प्रलेखित है।

कमांड संदर्भ

Cover को रोकने से क्लाइंट कॉन्फ़िगरेशन नहीं बदलता। एक क्लाइंट जो अभी भी Cover की ओर इंगित है, वह तब तक कनेक्ट नहीं हो पाएगा जब तक Cover पुनरारंभ नहीं होता या क्लाइंट को उसके सीधे प्रदाता या राउटर की ओर वापस इंगित नहीं किया जाता।

गोपनीयता नीतियाँ

अंतर्निहित regex पहचान AWS और GCP कुंजियाँ, GitHub, GitLab, Slack, Stripe और Anthropic टोकन, निजी-कुंजी ब्लॉक, JWT, स्पष्ट सामान्य गुप्त असाइनमेंट, ईमेल, SSN, क्रेडिट कार्ड, फ़ोन नंबर और IBAN को कवर करती है। एक सादा OpenAI sk-... मान जानबूझकर एक समर्पित अंतर्निहित श्रेणी नहीं है। यदि आपके वातावरण को इसकी आवश्यकता हो तो एक स्पष्ट नियम परिभाषित करें।

नियम ~/.config/cover/config.yaml में rules के अंतर्गत रहते हैं। एक चयनकर्ता नियमित अभिव्यक्ति, builtin_* डिटेक्टर, या JSON ऑब्जेक्ट कुंजियों की सूची हो सकता है।

rules:
  password_fields:
    keys: [password, passwd, pwd, passphrase, user_password, database_password]
    category: password
    action: pseudonymize
    generator: password
    priority: 220

  ipv4_addresses:
    detector: builtin_ipv4
    category: ip_address
    action: pseudonymize
    generator: ipv4
    priority: 100

  customer_name:
    pattern: '(?i)\bNIKE\b'
    category: customer
    action: pseudonymize
    generator: alias
    priority: 80

  forbidden_secret:
    pattern: '(?i)secret\s*[:=]\s*(?P<value>[^\s,;]+)'
    action: block
    priority: 200

कुंजी चयनकर्ता पूर्ण स्ट्रिंग मानों की सुरक्षा करते हैं। उदाहरण के लिए, {"password":"admin"} सुरक्षित है, बिना किसी असंबद्ध {"username":"admin"} को पासवर्ड के रूप में माने। नामित (?P<value>...) समूह regex को केवल पकड़े गए मान को बदलने देते हैं।

छद्मनाम जनरेटर: ipv4, ipv6, hostname, domain, fqdn, email, username, password, secret, uuid, url, और alias।

नियम स्टार्टअप पर मान्य किए जाते हैं। अमान्य चयनकर्ता, अभिव्यक्तियाँ, क्रियाएँ, जनरेटर या कैप्चर समूह Cover को शुरू होने से रोकते हैं। डिटेक्टर त्रुटियाँ, मैपिंग समाप्ति, विकृत JSON, संपीड़ित बॉडी और स्पष्ट ब्लॉक मूल अनुरोध को अग्रेषित करने पर वापस नहीं जाते।

स्थिर छद्मनाम और प्रतिवर्ती मैपिंग

Cover ~/.config/cover/pseudonym.key को केवल-स्वामी अनुमतियों के साथ बनाता है। HMAC-SHA-256 सत्रों और पुनरारंभों में समान मूल मान के लिए समान छद्मनाम प्राप्त करता है। विभिन्न स्थापनाएँ अलग-अलग छद्मनाम उत्पन्न करती हैं।

कुंजी मूल मानों को पुनर्प्राप्त नहीं कर सकती। पुनर्स्थापना केवल प्रक्रिया मेमोरी में रखे गए सीमित मैपिंग का उपयोग करती है। मैपिंग X-Cover-Session द्वारा अलग की जाती हैं, कॉन्फ़िगर की गई TTL के बाद समाप्त हो जाती हैं, और जब एक पृथक अनुरोध पूरा होता है तो हटा दी जाती हैं। कुंजी का बैकअप केवल तभी लें जब स्थिर छद्मनाम निरंतरता मायने रखती हो।

निरीक्षण, निदान और निगरानी

भेजे बिना पूर्वावलोकन

cover inspect request.json
cover inspect request.json --session demo

रिपोर्ट में रूपांतरित अनुरोध, मेल खाते नियम, श्रेणियाँ, क्रियाएँ, चेतावनियाँ और अवरुद्ध स्थिति होती है। यह नेटवर्क अनुरोध नहीं भेजता या प्रतिवर्ती मैपिंग प्रिंट नहीं करता।

स्थापना जाँचें

cover doctor
cover doctor --json

Doctor कॉन्फ़िगरेशन, लिसनर नीति, सीमाएँ, छद्मनाम कुंजी, रिडैक्शन राउंड ट्रिप, अपस्ट्रीम-लूप सुरक्षा, डेमन, फेल-क्लोज़ व्यवहार, ऑडिट लॉग, पर्यावरण रूटिंग, Codex प्रदाता और Codex अनुरोध संपीड़न को मान्य करता है। इसकी लाइव प्रोब स्थानीय रूप से अस्वीकार कर दी जाती है और मॉडल टोकन खर्च नहीं करती।

डिफ़ॉल्ट रूप से सुरक्षित निगरानी

cover monitor
cover monitor --follow=false -n 50
cover monitor --json

डिफ़ॉल्ट मॉनिटर केवल अनुमत-सूचीबद्ध मेटाडेटा दिखाता है: समय, HTTP स्थिति, परिवर्तन गणना, बाइट गणना, विलंबता, श्रेणियाँ और सामान्य त्रुटियाँ। ऑडिट लॉग में कभी भी अनुरोध या प्रतिक्रिया बॉडी, मेल खाते मान, मैपिंग, पथ, क्वेरी या अपस्ट्रीम क्रेडेंशियल नहीं होते।

स्पष्ट संवेदनशील लाइव दृश्य

cover monitor --show-content
cover monitor --show-content --once
cover monitor --show-content --json

यह ऑप्ट-इन दृश्य प्रत्येक पकड़े गए मूल और प्रतिस्थापन को दिखाता है, उसके बाद अपस्ट्रीम ट्रांसपोर्ट को दिया गया सटीक रूपांतरित JSON दिखाता है। यह केवल-लाइव है और ऑडिट लॉग में कभी नहीं जोड़ा जाता। कैप्चर एक प्रमाणित स्थानीय व्यूअर के कनेक्ट होने के बाद शुरू होता है और उसके डिस्कनेक्ट होने पर रुक जाता है। स्ट्रीम केवल-लूपबैक है, इंस्टॉलेशन कुंजी से प्राप्त टोकन का उपयोग करती है, और धीमे व्यूअर को डिस्कनेक्ट कर देती है।

[!WARNING] यह टर्मिनल आउटपुट संवेदनशील है। साझा टर्मिनलों, रिकॉर्ड किए गए सत्रों, CI लॉग्स या सहायता प्रतिलेखों में --show-content का उपयोग न करें।

क्लाइंट्स को कनेक्ट करें

Cover अनुरोध विधियों, पथों, क्वेरी और हेडर को कॉन्फ़िगर किए गए अपस्ट्रीम पर अग्रेषित करता है। मौजूदा प्रदाता प्रमाणीकरण अभी भी काम करता है क्योंकि Cover प्रमाणीकरण हेडर को फिर से नहीं लिखता।

Codex और Codex Router

Codex Responses API का उपयोग करता है। ~/.codex/config.toml में एक उपयोगकर्ता-स्तरीय प्रदाता जोड़ें और अनुरोध संपीड़न अक्षम करें ताकि Cover बॉडी का निरीक्षण कर सके:

model_provider = "cover"

[model_providers.cover]
name = "Cover"
base_url = "http://127.0.0.1:8317"
wire_api = "responses"
requires_openai_auth = true
supports_websockets = false

[features]
enable_request_compression = false

ये कुंजियाँ आधिकारिक Codex कॉन्फ़िगरेशन संदर्भ का पालन करती हैं। यदि [features] पहले से मौजूद है, तो सेटिंग उस तालिका में जोड़ें। ऐसे राउटर के लिए जो पर्यावरण से टोकन पढ़ता है, requires_openai_auth को env_key = "YOUR_ROUTER_KEY_ENV_NAME" से बदलें।

Cover के upstream को वास्तविक राउटर URL की ओर इंगित रखें। configs/codex-router.example.yaml को प्रारंभिक बिंदु के रूप में उपयोग करें। चयनित मॉडल OpenAI, Anthropic, Gemini, DeepSeek या कोई अन्य मॉडल हो सकता है क्योंकि Cover राउटर के सामान्य JSON ट्रैफ़िक पर कार्य करता है।

Responses API के encrypted_content फ़ील्ड अपारदर्शी और क्रिप्टोग्राफ़िक रूप से सत्यापित होते हैं। Cover उन्हें अनुरोध स्कैनिंग और प्रतिक्रिया पुनर्स्थापना के दौरान अपरिवर्तित छोड़ देता है।

Claude Code, SDKs और अन्य क्लाइंट्स

export ANTHROPIC_BASE_URL=http://127.0.0.1:8317
export OPENAI_BASE_URL=http://127.0.0.1:8317/v1

Claude Code पहले रूप का उपयोग करता है। OpenAI-संगत SDKs और क्लाइंट्स सामान्यतः /v1 रूप का उपयोग करते हैं। इंस्टॉलर इन सेटिंग्स को स्थायी रख सकता है, और cover env स्थापना के दौरान चयनित क्लाइंट्स के लिए एक्सपोर्ट्स प्रिंट करता है।

client = OpenAI(base_url="http://127.0.0.1:8317/v1", api_key=os.environ["OPENAI_API_KEY"])
client = anthropic.Anthropic(base_url="http://127.0.0.1:8317", api_key=os.environ["ANTHROPIC_API_KEY"])

Cursor और अन्य एप्लिकेशन समान एंडपॉइंट का उपयोग कर सकते हैं जब वे API बेस URL सेटिंग उजागर करते हैं। cover doctor या cover monitor से रूटिंग की पुष्टि करें।

Pi और Oh My Pi

आधिकारिक हार्नेस एक्सटेंशन Pi या Oh My Pi से Cover को नियंत्रित करता है, जबकि गोपनीयता इंजन स्थानीय Go प्रॉक्सी में रहता है:

pi install npm:cover-harness
# or
omp plugin install cover-harness

केवल उन प्रदाताओं को कॉन्फ़िगर करें जिन्हें वर्तमान Cover अपस्ट्रीम से गुजरना चाहिए:

/cover providers openai-codex,deepseek=/
/cover on
/cover doctor

OpenAI-परिवार के प्रदाता डिफ़ॉल्ट रूप से /v1 प्रॉक्सी पथ का उपयोग करते हैं। =/ उन ट्रांसपोर्टों के लिए प्रॉक्सी रूट का चयन करता है जो अपना स्वयं का अनुरोध पथ जोड़ते हैं, जैसे DeepSeek। सामान्य संचालन के लिए /cover status, /cover start, /cover stop, और /cover monitor का उपयोग करें। /cover off सीधे प्रदाता रूटिंग को पुनर्स्थापित करता है।

सुरक्षा फेल-क्लोज़ है: सक्षम होने पर, कॉन्फ़िगर किए गए प्रदाता Cover की ओर इंगित रहते हैं जब उसका डेमन अनुपलब्ध होता है, इसलिए प्रॉक्सी को बायपास करने के बजाय अनुरोध स्थानीय रूप से विफल होते हैं। एक्सटेंशन स्थिति ~/.config/cover/harness.json पर निजी और स्थानीय होती है।

वही पैकेज Pi पैकेज गैलरी में दिखाई देता है। OMP उपयोगकर्ता इस रिपॉज़िटरी को मार्केटप्लेस के रूप में भी जोड़ सकते हैं:

omp plugin marketplace add DavidCarliez/cover
omp plugin install cover-harness@cover

वैकल्पिक स्थानीय LLM डिटेक्टर

Regex और कुंजी-जागरूक नियम हर नाम, पता, ग्राहक ID या आंतरिक कोडनेम की पहचान नहीं कर सकते। Cover एक छोटे स्थानीय llama.cpp मॉडल को अतिरिक्त सिमेंटिक डिटेक्टर के रूप में चला सकता है।

cover models pull
cover models status
cover restart

डिफ़ॉल्ट मॉडल लगभग 490 MB Q4 GGUF में Qwen2.5-0.5B-Instruct है। Cover लूपबैक पर llama-server शुरू करता है और प्रति-कॉल तथा समग्र अनुरोध बजट लागू करता है। लापता बाइनरी, स्टार्टअप विफलताएँ, टाइमआउट और डिटेक्टर त्रुटियाँ डिटेक्टर सक्षम होने पर फेल-क्लोज़ होती हैं। लौटाए गए स्पैन Cover द्वारा स्वीकार किए जाने से पहले इनपुट में शब्दशः मौजूद होने चाहिए।

असमर्थित प्लेटफ़ॉर्मों पर इस सुविधा को अक्षम रखें। सीमाओं, बैचिंग, समवर्तीता और मॉडल पथों के लिए configs/config.example.yaml में detectors.llm_fallback अनुभाग देखें।

सुरक्षा सीमा

Cover JSON बॉडी में मेल खाने वाले स्ट्रिंग मानों की सुरक्षा करता है जो वास्तव में प्रॉक्सी से गुजरते हैं। यह हर संवेदनशील मान की खोज करने का दावा नहीं करता।

डेटा अभी भी मशीन से बाहर जा सकता है जब वह इनमें दिखाई दे:

• एक मान जिसे कोई सक्षम डिटेक्टर या नियम पहचान नहीं पाता;
• एक फ़ील्ड जो allow नियम द्वारा कवर किया गया है;
• HTTP हेडर, URL पथ या क्वेरी स्ट्रिंग्स;
• छवि पिक्सेल, बाइनरी मीडिया या असमर्थित एन्कोडिंग;
• गैर-स्ट्रिंग JSON मान;
• संरचनात्मक प्रोटोकॉल फ़ील्ड जैसे model, role, type, IDs, और tool या function नाम;
• अपारदर्शी encrypted_content, जो प्रोटोकॉल सुरक्षा के लिए अपरिवर्तित रहना चाहिए;
• उस क्लाइंट से ट्रैफ़िक जो Cover को बायपास करता है।

इनलाइन छवि प्रबंधन media.images: allow, warn, या block के साथ कॉन्फ़िगर करने योग्य है। Cover पिक्सेल का निरीक्षण नहीं करता, और कोई भी मीडिया नीति हर संभव एन्कोडिंग को पहचान नहीं सकती।

Cover गैर-लूपबैक लिसनर को तब तक अस्वीकार करता है जब तक network.allow_remote: true स्पष्ट रूप से कॉन्फ़िगर न किया गया हो। यदि Cover और उसका अपस्ट्रीम राउटर अलग-अलग होस्ट पर चलते हैं, तो TLS या किसी अन्य विश्वसनीय ट्रांसपोर्ट का उपयोग करें और अलग नेटवर्क एक्सेस नियंत्रण लागू करें। Cover स्वयं सामान्य प्रॉक्सी ट्रैफ़िक को प्रमाणित नहीं करता।

अनुरोध, बफ़र-प्रतिक्रिया, कुल-स्ट्रीम और प्रति-SSE-घटना सीमाएँ मेमोरी उपयोग को बाध्य करती हैं। अत्यधिक बड़े अनुरोध HTTP 413 लौटाते हैं, अत्यधिक बड़ी बफ़र प्रतिक्रियाएँ HTTP 502 लौटाती हैं, और अत्यधिक बड़ी स्ट्रीम समाप्त कर दी जाती हैं।

कमजोरी की रिपोर्ट करने से पहले SECURITY.md पढ़ें। कृपया सार्वजनिक issue खोलने के बजाय वहाँ वर्णित निजी रिपोर्टिंग मार्ग का उपयोग करें।

परियोजना

• विकास और परीक्षण: CONTRIBUTING.md
• आचार: CODE_OF_CONDUCT.md
• लाइसेंस: Apache License 2.0