
AI-लिखित कोड के लिए सिमेंटिक ग्राफ-आधारित वर्ज़न कंट्रोल। फ़ाइल डिफ़ के बजाय एंटिटीज़ और रिलेशन्स को ट्रैक करता है, जिससे ब्लास्ट रेडियस एनालिसिस, शैडो मर्ज रिव्यू, और भरोसेमंद AI-जनित सॉफ़्टवेयर के लिए MCP-संचालित एजेंट कॉन्टेक्स्ट संभव होता है।
<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/kinlab-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/kinlab-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 kinlab-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/stores` में रखता है, और रिपॉज़िटरी में कुछ नहीं लिखता; `kin store path` प्रिंट करता है कि किसी चेकआउट का स्टोर कहाँ है। डिफ़ॉल्ट रूप से यह पहले चेकआउट किए गए कमिट को स्वीकार करता है, ताकि वह ट्री पढ़े जाते ही प्रश्नों के उत्तर मिल सकें, और फिर पृष्ठभूमि में, कम प्राथमिकता पर, उन सभी कमिट को आयात करता है जिन तक आपकी ब्रांच और टैग पहुँचते हैं; `kin init --history full` पूरा इतिहास शुरू में ही आयात करता है, और `--history none` इसे कभी आयात नहीं करता। इतिहास आयात करने में समय, मेमोरी और डिस्क लगती है जो चेकआउट के आकार के बजाय इतिहास के साथ बढ़ती है। शुरू होने से पहले, `kin init` मेमोरी और खाली डिस्क की जाँच करता है और जब वह पहले से बता सकता है कि मशीन में कमी है तो संख्याओं के साथ रुक जाता है। **एक शैलो क्लोन केवल अपने चेकआउट किए गए कमिट को स्वीकार करता है, और सबमॉड्यूल और Git LFS समर्थित नहीं हैं**, और Git हुक, स्पार्स चेकआउट या अधूरा मर्ज या रीबेस भी आयात को रोक देते हैं। `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 सीमाएँ](#beta-limits) के अंतर्गत Windows प्रविष्टि बताती है कि वहाँ क्या काम करता है। कोई नेटिव Windows ARM64 बिल्ड प्रकाशित नहीं है। ARM64 मशीन पर, उस पंक्ति को x64 PowerShell से चलाकर एमुलेशन के अंतर्गत x86_64 बिल्ड इंस्टॉल करें, या 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 में `&&` नहीं होता, इसलिए native 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>" ``` Replace `ExactEntityName` below with a symbol from the result: ```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 के अंदर कनेक्ट करें। `kin runtime status --json` साझा CLI और daemon इंस्टॉलेशन की जाँच करता है, जिसमें उनकी सटीक स्रोत पहचान शामिल है। सामान्य कमांड बेमेल जोड़ियों को अस्वीकार करते हैं; डेवलपमेंट बिल्ड्स पृथक स्थिति का उपयोग करते हैं। देखें [runtime installation](https://github.com/firelock-ai/kin/blob/main/docs/runtime-installation.md)। ग्राफ़ और लेक्सिकल रिट्रीवल बिना किसी मॉडल के काम करते हैं। एम्बेडिंग्स और रीरैंकिंग वैकल्पिक हैं, और उनके मॉडल प्रदाता डिफ़ॉल्ट रूप से `none` पर सेट हैं। मानक CLI और daemon बिल्ड्स में बाहरी HTTP मॉडल समर्थन शामिल है। अंतर्निहित मॉडल्स के लिए वैकल्पिक स्थानीय इन्फ़रेंस सक्षम के साथ बिल्ड आवश्यक है। आपके द्वारा संचालित OpenAI-संगत एंडपॉइंट का उपयोग करके एम्बेडिंग इंडेक्स बनाने के लिए: ```sh KIN_MODEL_EMBEDDINGS_PROVIDER=external \ KIN_MODEL_EMBEDDINGS_BASE_URL=http://localhost:1234/v1 \ KIN_MODEL_EMBEDDINGS_MODEL=your-served-embedding-model kin embed ``` मॉडल एंडपॉइंट्स को अपने चरण के लिए आवश्यक चयनित एंटिटी टेक्स्ट प्राप्त होता है। [मॉडल सेटिंग्स](https://github.com/firelock-ai/kin/blob/main/docs/env-vars.md) प्रदाताओं, मॉडल पहचानों और क्रेडेंशियल एनवायरनमेंट वेरिएबल नामों का वर्णन करती हैं। 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 इंस्टॉल करने के लिए नेटवर्क एक्सेस आवश्यक है; डिफ़ॉल्ट ग्राफ़ रिट्रीवल पथ के लिए किसी मॉडल डाउनलोड की आवश्यकता नहीं है। जब कोई एम्बेडिंग प्रदाता चुना जाता है, तो क्वेरीज़ उसकी वेक्टर कवरेज और किसी भी अंतराल की रिपोर्ट करती हैं। ## किसी परिवर्तन की समीक्षा करें जिस Git ब्रांच की आप समीक्षा करना चाहते हैं, उस पर `kin init` चलाने के बाद, स्पष्ट कमिट SHA की तुलना `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 में नहीं। स्टोर को हटाकर Git से पुनः आयात करने पर वे पुनर्प्राप्त नहीं होते, इसलिए पहले `kin backup create` चलाएँ। इसी कारण `kin store prune` स्टोर को केवल तब हटाता है जब आप `--yes` पास करते हैं। [आयात, पुनर्प्राप्ति और अपग्रेड नोट्स](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) · [इश्यू](https://github.com/kinlab-ai/kin/issues/new/choose) · [सुरक्षा](https://github.com/firelock-ai/kin/blob/main/SECURITY.md) Kin और इसका स्थानीय स्टैक, जिसमें [kin-db](https://github.com/kinlab-ai/kin-db) शामिल है, [Apache-2.0](https://github.com/firelock-ai/kin/blob/main/LICENSE) हैं। [KinLab](https://kinlab.ai) एक अलग स्वामित्व वाला होस्टेड उत्पाद है। सार्वजनिक रिपॉज़िटरी ऑनबोर्डिंग अभी विकास में है।