kin

<p align="center">
  <img src="https://assets.kitploit.com/production/public/readmes/12665/55686ad4696e166589300e948ce2ed89f45622266654371a433a31c612829ec8.png" alt="Kin, लोगों और AI एजेंट्स के लिए एक कोड रिपॉज़िटरी" width="100%" />
</p>

<h3 align="center">कोड के लिए एक नई नींव।</h3>

<p align="center">
  <a href="https://github.com/firelock-ai/kin/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-Apache--2.0-blue.svg" alt="Apache-2.0" /></a>
  <a href="https://github.com/firelock-ai/kin/releases/latest"><img src="https://img.shields.io/badge/release-latest-6E56CF.svg" alt="Latest release" /></a>
</p>

**Kin लोगों और AI एजेंट्स के लिए एक ग्राफ़-नेटिव कोड रिपॉज़िटरी है।** यह सोर्स, रिकॉर्ड किए गए कोड संबंधों, और वर्ज़न्ड इतिहास को रिपॉज़िटरी स्टेट के रूप में संग्रहीत करता है। ग्राफ़ ही रिपॉज़िटरी मॉडल है, किसी अन्य रिपॉज़िटरी के साथ-साथ बनाए रखा गया सर्च इंडेक्स नहीं।

फ़ंक्शन, टाइप, और उनके बीच के संबंध ऐसा डेटा हैं जिन्हें आप कमिट, ब्रांच, और मर्ज करते हैं। सटीक सोर्स बाइट-दर-बाइट संरक्षित रहता है, और फ़ाइलसिस्टम प्रोजेक्शन समर्थित टूल्स को साधारण फ़ाइलों के साथ काम करते रहने देते हैं।

**पब्लिक बीटा।** Kin को किसी ऐसे असली प्रोजेक्ट पर आज़माएँ जिसे आप अच्छी तरह जानते हैं। खुरदुरे किनारों की अपेक्षा करें।

[क्विकस्टार्ट](#quickstart) · [डॉक्युमेंटेशन](https://github.com/firelock-ai/kin/blob/main/docs/quickstart.md) · [ब्राउज़र डेमो](https://kinlab.ai/demo)

<p align="center">
  <img src="https://raw.githubusercontent.com/firelock-ai/kin/main/docs/assets/kin-impact-human-bytes.gif" alt="kin impact human_bytes --file crates/kin-cli/src/commands/cache.rs --kind function --depth 1, जो Kin के अपने कोडबेस में इसके सीधे कॉलर्स को उसी नाम की git grep खोज के साथ दिखाता है" width="100%" />
</p>

एक स्टार दूसरों को Kin खोजने में मदद करता है, और [Discussions](https://github.com/firelock-ai/kin/discussions) वह जगह है जहाँ इसके बारे में सवाल लेकर आ सकते हैं।

## देखें क्या जुड़ता है

किसी साझा फ़ंक्शन को बदलने से पहले, आपको और क्या जाँचना चाहिए? Kin आपको इसके रिकॉर्ड किए गए कॉलर्स देखने और संबंधित कोड का पता लगाने देता है। CLI और MCP सर्वर एक ही ग्राफ़ को क्वेरी करते हैं, ताकि आप और आपका एजेंट एक ही रिकॉर्ड से काम कर सकें।

<img src="https://assets.kitploit.com/production/public/readmes/12665/43f73477ba09d6aa7a5bb446cadaea9c36981cc1d093faacaa03b9b61346b955.png" alt="ripgrep पर एक रिकॉर्ड किया गया kin impact क्वेरी, जो सिग्नेचर बदलाव के लिए संबंधित एंटिटीज़ दिखाती है" width="100%" />

*`e89fff89ac9af12e8d4ce9d5fd07beb408ca730f` पर तैयार किए गए ripgrep ग्राफ़ पर रिकॉर्ड किया गया। रॉ रन आर्टिफ़ैक्ट्स सार्वजनिक नहीं हैं। यह एक वर्कफ़्लो दर्शाता है, परफ़ॉर्मेंस बेंचमार्क नहीं।*

## इसे Claude Code, Codex या Cursor से उपयोग करें

Claude Code के लिए:

```
/plugin marketplace add firelock-ai/kin
/plugin install kin@kin
```

[Codex](https://github.com/firelock-ai/kin/blob/main/plugins/kin-codex/README.md#install) के लिए, मार्केटप्लेस जोड़ें और प्लगइन इंस्टॉल करें, या `kin setup --intent agent` को आपके लिए `~/.codex/config.toml` में MCP सर्वर लिखने दें।

Cursor के लिए, MCP सर्वर को हाथ से जोड़ें; सटीक स्निपेट के लिए [plugins/kin-cursor](https://github.com/firelock-ai/kin/blob/main/plugins/kin-cursor/README.md#install) देखें।

इंस्टॉल करने के बाद, किसी ऐसे प्रोजेक्ट के ताज़ा क्लोन में `kin init .` चलाएँ जिसे आप अच्छी तरह जानते हैं; `kin-setup` स्किल आपको बाकी सब में मार्गदर्शन करती है।

Kin crates.io पर प्रकाशित नहीं है। वहाँ का `kin` क्रेट एक असंबंधित प्रोजेक्ट है।

## क्विकस्टार्ट

किसी ऐसे प्रोजेक्ट के ताज़ा, पूर्ण क्लोन में शुरू करें जिसे आप अच्छी तरह जानते हैं। `kin init` आपके Git इतिहास को बिना बदले या आपकी ट्रैक की गई फ़ाइलों को बदले पढ़ता है। यह एक `.kin` डायरेक्टरी और `.git/info/exclude` में एक पंक्ति जोड़ता है। इम्पोर्ट आपकी ब्रांच और टैग जिन कमिट्स तक पहुँचते हैं उन सभी को कवर करता है, इसलिए समय, मेमोरी और डिस्क चेकआउट के आकार के बजाय इतिहास के साथ बढ़ते हैं। शुरू होने से पहले, `kin init` मेमोरी और खाली डिस्क जाँचता है और जब वह पहले से बता सकता है कि मशीन कम है तो संख्याओं के साथ रुक जाता है। **Shallow clones, submodules और Git LFS समर्थित नहीं हैं**, और Git hooks, sparse checkout या अधूरा merge या rebase भी इम्पोर्ट रोक देते हैं। `kin init` हर एक के लिए समाधान बताता है, और एक ताज़ा क्लोन इनमें से अधिकांश से बच जाता है।

### 1. इंस्टॉल करें

macOS, Linux और WSL2 पर, एक कमांड Kin इंस्टॉल करता है और उसे मिलने वाले AI कोडिंग टूल्स को कनेक्ट करता है। इसके लिए Node.js 20 या नया चाहिए:

```sh
npx -y @kinlab/kin setup
```

Node के बिना किसी मशीन पर, इसके बजाय इंस्टॉलर चलाएँ। `get.kinlab.ai` और `get.kinlab.dev` एक ही स्क्रिप्ट सर्व करते हैं:

```sh
curl -fsSL https://get.kinlab.dev/install | sh
```

किसी भी तरह, अपने शेल को एक अलग कमांड के रूप में रीलोड करें, क्योंकि इंस्टॉल `kin` को `~/.kin/bin` में रखता है और नए सेशन्स के लिए उस डायरेक्टरी को आपके शेल प्रोफ़ाइल में जोड़ता है:

```sh
exec "$SHELL" -l
```

नेटिव Windows x64 पर, PowerShell से `irm https://get.kinlab.dev/install.ps1 | iex` के साथ इंस्टॉल करें। यह `kin` CLI इंस्टॉल करता है और AI कोडिंग टूल्स को कनेक्ट नहीं करता, क्योंकि Windows पर WSL2 ही अनुशंसित रास्ता बना हुआ है। [Beta limits](#beta-limits) के अंतर्गत Windows प्रविष्टि बताती है कि वहाँ क्या काम करता है। कोई नेटिव Windows ARM64 बिल्ड प्रकाशित नहीं है। ARM64 मशीन पर, emulation के तहत x86_64 बिल्ड इंस्टॉल करने के लिए वह पंक्ति x64 PowerShell से चलाएँ, या WSL2 उपयोग करें। इंस्टॉलर `kin` को आपके यूज़र PATH में जोड़ता है, इसलिए अगले चरण से पहले `exec "$SHELL" -l` के स्थान पर एक नई PowerShell विंडो खोलें।

अन्य इंस्टॉलर या समस्या-निवारण के लिए, [पूरा क्विकस्टार्ट](https://github.com/firelock-ai/kin/blob/main/docs/quickstart.md#1-install) देखें।

### 2. रिपॉज़िटरी इनिशियलाइज़ करें

नए प्रॉम्प्ट पर, Kin के साथ एक रिपॉज़िटरी क्लोन करें:

```sh
kin clone https://github.com/pallets/itsdangerous
```

या जो आपके पास पहले से है उसे इनिशियलाइज़ करें, नीचे दिए पथ को बदलते हुए:

```sh
cd /path/to/your/repository &&
kin init . &&
kin overview &&
kin status
```

दोनों अगले चलाने वाले कमांड के साथ समाप्त होते हैं, उस रिपॉज़िटरी में किसी फ़ंक्शन के बारे में एक `kin refs` प्रश्न। जब आपने सेटअप में अनुमति दी थी तो वे Codex CLI और Grok CLI को भी उससे कनेक्ट करते हैं, क्योंकि वे क्लाइंट्स एक प्रविष्टि रखते हैं जो एक रिपॉज़िटरी का नाम लेती है।

Windows PowerShell 5.1 में `&&` नहीं है, इसलिए नेटिव Windows पर वही कमांड एक-एक करके चलाएँ और किसी के विफल होने पर रुक जाएँ:

```powershell
cd C:\path\to\your\repository
kin init .
kin overview
kin status
```

`kin overview` वे एंटिटीज़ दिखाता है जो Kin ने इम्पोर्ट कीं। `kin status` दिखाता है कि क्या स्वीकार किया गया और उसके सापेक्ष वर्किंग ट्री की स्थिति। `kin graph status` डेमन के लाइव क्वेरी ग्राफ़ और कवरेज की रिपोर्ट करता है। अनकमिटेड और अनट्रैक्ड बदलाव इम्पोर्ट किए गए Git इतिहास का हिस्सा नहीं हैं; `kin init` बताता है कि उसने क्या छोड़ा।

### 3. एक ऐसा प्रश्न पूछें जिसे आप जाँच सकें

कुछ ऐसा खोजें जो आप पहले से जानते हैं कि कोड में है:

```sh
kin locate "<something you already know is in this repository>"
```

नीचे `ExactEntityName` को परिणाम से किसी सिंबल से बदलें:

```sh
kin refs ExactEntityName
kin trace ExactEntityName
kin impact ExactEntityName
```

`refs` रिकॉर्ड किए गए संदर्भ लौटाता है, `trace` आस-पास का संदर्भ लाता है, और `impact` ग्राफ़ के माध्यम से संभावित प्रभावों का पता लगाता है। परिणामों को सोर्स के विरुद्ध जाँचें।

### 4. आपके AI कोडिंग टूल्स और सिमैंटिक सर्च

`kin setup` ने उन AI कोडिंग टूल्स को कनेक्ट करने से पहले पूछ लिया था जो उसे मिले, और यदि आपने हाँ कहा तो उन्हें कनेक्ट कर दिया। कोई अलग लिंकिंग चरण नहीं है। किसी अन्य टूल को इंस्टॉल करने के बाद, `kin setup` फिर से चलाएँ, और `kin setup status` दिखाता है कि क्या कनेक्ट है। Windows पर, AI टूल्स को WSL2 के अंदर कनेक्ट करें।

सिमैंटिक सर्च लगभग 523 MB के एक लोकल मॉडल पर चलती है, और कुछ भी डाउनलोड होने से पहले सेटअप पूछता है। यदि आपने ना कहा, या `kin init` कहता है कि सर्च इंडेक्स मॉडल की प्रतीक्षा कर रहा है, तो यह इसे डाउनलोड करता है और इंडेक्स बनाता है:

```sh
kin embed
```

Kin Claude Code, Codex, Cursor, Gemini, और अन्य MCP क्लाइंट्स का समर्थन करता है। VS Code के लिए `kin setup --intent editor` उपयोग करें। Kin में लोकल या होस्टेड OpenAI-संगत मॉडल एंडपॉइंट्स के लिए `kin agent run` भी शामिल है।

[क्लाइंट कॉन्फ़िगरेशन](https://github.com/firelock-ai/kin/blob/main/docs/readme-reference.md#works-with-your-agent) · [MCP टूल्स](https://github.com/firelock-ai/kin/blob/main/docs/mcp-tools.md) · [बिल्ट-इन एजेंट](https://github.com/firelock-ai/kin/blob/main/docs/cli-reference.md#kin-agent)

लोकल इम्पोर्ट, स्टोरेज, और क्वेरीज़ आपकी मशीन पर चलती हैं। इंस्टॉलेशन और प्रारंभिक एम्बेडिंग-मॉडल डाउनलोड के लिए नेटवर्क एक्सेस चाहिए। एम्बेडिंग्स तैयार होने से पहले, `kin locate` लेक्सिकल और ग्राफ़ सिग्नल्स का उपयोग करता है और अनुपलब्ध वेक्टर कवरेज की रिपोर्ट करता है।

## किसी बदलाव की समीक्षा करें

जिस Git ब्रांच की आप समीक्षा करना चाहते हैं उस पर `kin init` चलाने के बाद, स्पष्ट कमिट SHAs की `main` से तुलना करें:

```sh
kin review shadow "$(git rev-parse main)..$(git rev-parse HEAD)"
```

रिपोर्ट `PASS`, `NEEDS ATTENTION`, या `WOULD BLOCK` लौटाती है, ग्राफ़-व्युत्पन्न प्रभाव और समर्थक साक्ष्य के साथ। **यह सलाहकारी है:** यह किसी मर्ज को ब्लॉक नहीं करती या ग्राफ़ स्टेट नहीं बदलती। लेखकत्व घोषित है, स्वतंत्र रूप से सत्यापित नहीं।

## Kin को Git के साथ या उसके बिना उपयोग करें

Kin के अपने कमिट, ब्रांच, मर्ज, डिफ़, और इतिहास हैं, जिनमें ऐसी रिपॉज़िटरीज़ भी शामिल हैं जिनके नीचे कोई Git नहीं है। मौजूदा Git रिपॉज़िटरीज़ को इम्पोर्ट किया जा सकता है, और समर्थित वर्कफ़्लो एक नई Git रिपॉज़िटरी एक्सपोर्ट कर सकते हैं।

[नेटिव वर्ज़न-कंट्रोल वॉकथ्रू](https://github.com/firelock-ai/kin/blob/main/docs/readme-reference.md#version-control-without-git) · [Git इंटरऑपरेबिलिटी और एक्सपोर्ट सीमाएँ](https://github.com/firelock-ai/kin/blob/main/docs/readme-reference.md#how-kin-relates-to-git)

## बीटा सीमाएँ

**कवरेज अधूरी है।** समर्थित भाषाएँ एंटिटीज़ और संबंधों में पार्स की जाती हैं; अन्य फ़ाइलें कंटेंट और इतिहास के रूप में उपलब्ध रहती हैं। खाली परिणाम यह साबित नहीं करता कि कोई कॉलर या निर्भरता नहीं है। अपने कंपाइलर, टेस्ट, और समीक्षा का उपयोग करते रहें। [भाषा समर्थन](https://github.com/firelock-ai/kin/blob/main/docs/language-support.md) देखें।

**संगतता अलग-अलग होती है।** रिलीज़ आर्काइव में डेप्रिकेटेड `kin-vfs` फ़ाइलसिस्टम प्रोजेक्शन शामिल नहीं है, इसलिए भरोसा करने के लिए कोई पारदर्शी प्रोजेक्शन नहीं है। प्रत्येक प्लेटफ़ॉर्म क्या समर्थन करता है, इसके लिए [प्लेटफ़ॉर्म नोट्स](https://github.com/firelock-ai/kin/blob/main/docs/readme-reference.md#platform-and-maturity) देखें।

**केवल-Kin स्टेट का बैकअप लें।** Kin के साथ रिकॉर्ड किए गए कमिट, ब्रांच, समीक्षाएँ और स्पेक्स `.kin` में रहते हैं, Git में नहीं। `.kin` हटाकर Git से फिर से इम्पोर्ट करने पर वे वापस नहीं आते, इसलिए पहले `kin backup create` चलाएँ। [इम्पोर्ट, रिकवरी, और अपग्रेड नोट्स](https://github.com/firelock-ai/kin/blob/main/docs/readme-reference.md#what-is-real-today-and-what-is-beta) पढ़ें।

**Windows।** नेटिव Windows x86_64 समर्थन शुरुआती है। रिपॉज़िटरी एडमिशन काम करता है: `kin init` एक Git रिपॉज़िटरी इम्पोर्ट करता है और ग्राफ़ अथॉरिटी प्रकाशित करता है, और ग्राफ़, लेक्सिकल, और डेमन-समर्थित क्वेरीज़ नेटिव रूप से उत्तर देती हैं। एंड-टू-एंड इंस्टॉल प्रमाण नेटिव Windows पर एजेंट सेटअप भी चलाता है और इंस्टॉल किए गए MCP सर्वर से ग्राफ़-समर्थित उत्तर प्राप्त करता है। पारदर्शी फ़ाइलसिस्टम प्रोजेक्शन Windows पर शिप नहीं किया गया है, और समीक्षा वर्कफ़्लो का वहाँ अभी परीक्षण नहीं हुआ है, इसलिए पूर्ण Kin अनुभव के लिए WSL2 ही अनुशंसित रास्ता बना हुआ है।

## मैंने Kin क्यों बनाया

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

यही मैं Kin के साथ बना रहा हूँ।

Troy

## और जानें और योगदान करें

[CLI संदर्भ](https://github.com/firelock-ai/kin/blob/main/docs/cli-reference.md) · [आर्किटेक्चर और विस्तृत सीमाएँ](https://github.com/firelock-ai/kin/blob/main/docs/readme-reference.md) · [योगदान](https://github.com/firelock-ai/kin/blob/main/CONTRIBUTING.md) · [Issues](https://github.com/firelock-ai/kin/issues/new/choose) · [सुरक्षा](https://github.com/firelock-ai/kin/blob/main/SECURITY.md)

Kin और इसका लोकल स्टैक, जिसमें [kin-db](https://github.com/firelock-ai/kin-db) शामिल है, [Apache-2.0](https://github.com/firelock-ai/kin/blob/main/LICENSE) हैं। [KinLab](https://kinlab.ai) अलग स्वामित्व वाला होस्टेड उत्पाद है। सार्वजनिक रिपॉज़िटरी ऑनबोर्डिंग अभी विकास में है।