kin v0.6.4 — The system of record for AI-written software. A persistent graph of entities, relationships, changes, and provenance, so humans and AI agents see what a change touches before it merges. Beside Git today.

Kin, the semantic system of record for AI-written software

डिफ़ अंतर नहीं है।

AI एजेंट किसी बदलाव को उससे कहीं तेज़ी से लिख सकते हैं जितनी तेज़ी से कोई टीम यह पता लगा सके कि वह किन चीज़ों को छूता है, क्या वह किसी पहले के फिक्स को उलट देता है, और उसके परिणाम कितनी दूर तक फैलते हैं। Git फ़ाइलों और लाइन इतिहास को रिकॉर्ड करता है। Kin सॉफ़्टवेयर को स्वयं एंटिटी, रिलेशन, बदलाव और प्रोवेनेंस के ग्राफ़ के रूप में रिकॉर्ड करता है, और फिर मनुष्यों और एजेंटों को क्वेरी और समीक्षा के लिए एक शब्दार्थ प्राधिकरण देता है। कोई बदलाव किन चीज़ों को छूता है, यह मर्ज होने से पहले ही दिख जाता है, और एजेंट रिपॉज़िटरी को दोबारा पढ़ने के बजाय सटीक संदर्भ से काम करते हैं।

Kin AI-लिखित सॉफ़्टवेयर के लिए शब्दार्थ रिकॉर्ड प्रणाली है। यह एक प्रारंभिक अल्फा है, जो आज स्थानीय CLI, डेमन, MCP सर्वर, समीक्षा सतह और ग्राफ़-समर्थित फ़ाइलसिस्टम प्रोजेक्शन के रूप में उपयोग योग्य है। यह pre-1.0 है, इसलिए खुरदरे किनारों और ब्रेकिंग बदलावों की उम्मीद करें। किसी महत्वपूर्ण वर्कफ़्लो में अपनाने से पहले नवीनतम स्थिर रिलीज़ और वर्तमान सीमाएँ देखें।

इसे एक वास्तविक रिपॉज़िटरी पर देखें

ripgrep में एक-पंक्ति का सिग्नेचर बदलाव डिफ़ में हानिरहित दिखता है। किसी भी कंपाइलर के चलने से पहले kin impact से पूछें, और यह बताता है कि संपादन किन चीज़ों तक पहुँचता है। बदले हुए सिग्नेचर के कॉलर पहले आते हैं, फिर वह सब कुछ जो वे कॉलर अपने पीछे खींचते हैं।

kin impact on ripgrep: a one-line signature edit, and Kin surfaces the entities it affects before a compiler runs

ripgrep कमिट e89fff89ac9af12e8d4ce9d5fd07beb408ca730f पर एक तैयार ग्राफ़ के विरुद्ध रिकॉर्ड किया गया। एक-पंक्ति का सिग्नेचर संपादन, और Kin कंपाइलर के चलने से पहले उन एंटिटी को सतह पर लाता है जिन्हें यह प्रभावित करता है। ग्राफ़ पहले से बनाया गया था। कोई कंपाइलर नहीं चला। सटीक कमांड: kinlab.ai/proof। कच्ची रन निर्देशिका अभी सार्वजनिक नहीं है, इसलिए यह एक ऐसी रेसिपी है जिसे आप दोबारा चला सकते हैं, न कि एक ट्रेस जिसे आप ऑडिट कर सकते हैं।

Kin सतह पर लाता है कि बदलाव किन चीज़ों को छूता है। बदलाव सही है या नहीं, यह आपके कंपाइलर, टेस्ट और समीक्षा पर निर्भर रहता है। ग्राफ़ पहले से kin init द्वारा बनाया जाता है, और इसे बनाना महंगा हिस्सा है; उसके बाद, प्रभाव प्रश्नों का उत्तर ग्राफ़ सत्य से दिया जाता है, न कि ट्री को दोबारा पढ़कर।

स्टैक

Kin एक प्रणाली है जिसमें कुछ स्पष्ट सार्वजनिक सतहें हैं:

सतह	यह क्या करती है
kin	शब्दार्थ रिकॉर्ड प्रणाली: CLI, डेमन, ग्राफ़ जीवनचक्र, MCP, समीक्षा, प्रोवेनेंस और Git सह-अस्तित्व।
kin-vfs	ग्राफ़-स्वामित्व वाली फ़ाइलों को सामान्य फ़ाइलसिस्टम कॉल के माध्यम से प्रोजेक्ट करता है ताकि मौजूदा टूल फ़ाइलों का उपयोग जारी रख सकें।
kin-editor	एंटिटी एक्सप्लोरर, शब्दार्थ खोज, ट्रेस, समीक्षा और रीनाम सतहों तक VS Code पहुँच।
Kin MCP	AI एजेंटों के लिए टाइप किए गए ग्राफ़ टूल, `kin` में बंडल और `kin mcp start` के साथ लॉन्च किए गए।
KinLab	होस्टेड सहयोग और नियंत्रण तल। सार्वजनिक रिपॉज़िटरी कनेक्शन अभी पहली-रन प्रवाह नहीं है।

टुकड़े कैसे फिट होते हैं

Kin AI-लिखित सॉफ़्टवेयर के लिए शब्दार्थ रिकॉर्ड प्रणाली है, और नीचे के नक्शे में सब कुछ या तो उस प्राधिकरण तक पहुँचता है या उसका समर्थन करता है। मनुष्य और AI एजेंट CLI, बंडल MCP सर्वर या VS Code एक्सटेंशन के माध्यम से आते हैं। तीनों एक ही डेमन से पूछते हैं, और डेमन ट्री को दोबारा पढ़ने के बजाय ग्राफ़ प्राधिकरण से उत्तर देता है। kin-vfs उसी ग्राफ़ को सामान्य फ़ाइलसिस्टम कॉल के माध्यम से वापस प्रोजेक्ट करता है, ताकि एडिटर, कंपाइलर और बिल्ड सिस्टम फ़ाइलें देखते रहें। Git ग्राफ़ के बगल में उत्तर पथ के बजाय आयात और निर्यात सीमा के रूप में बैठता है, और KinLab उसी प्राधिकरण के ऊपर होस्टेड परत है।```mermaid flowchart TD people["Humans and AI agents"]

subgraph surfaces["Access surfaces"]
    cli["kin CLI"]
    mcp["Kin MCP server"]
    editor["kin-editor for VS Code"]
end

daemon["kin daemon"]
authority["Graph authority<br/>entities, relations, changes, provenance"]
db["kin-db<br/>graph storage, snapshots,<br/>index, text and vector search"]
prims["kin-model, kin-blobs, kin-search,<br/>kin-vector, kin-infer, kin-lsp"]
vfs["kin-vfs<br/>transparent file projection"]
tools["Editors, compilers, build systems"]
git["Git<br/>import and export boundary"]
kinlab["KinLab<br/>hosted collaboration and control plane"]

people --> cli
people --> mcp
people --> editor
cli --> daemon
mcp --> daemon
editor --> daemon
daemon --> authority
authority --> db
db --> prims
authority <-->|"kin init imports, kin git export"| git
authority -->|"publish and sync"| kinlab
authority --> vfs
vfs --> tools

इन सतहों के नीचे वे परतें हैं जिनसे सिस्टम बना है:

| Layer | Role |
| --- | --- |
| **[kin-db](https://github.com/firelock-ai/kin-db)** | ग्राफ़ स्टोरेज, स्नैपशॉट, इंडेक्सिंग, टेक्स्ट खोज, और वेक्टर खोज। |
| **[kin-model](https://github.com/firelock-ai/kin-model)** | कैनोनिकल प्रकार और डोमेन मॉडल जो पूरे स्टैक में साझा किए जाते हैं। |
| **[kin-blobs](https://github.com/firelock-ai/kin-blobs)** | कंटेंट-एड्रेसेबल ब्लॉब स्टोरेज। |
| **[kin-search](https://github.com/firelock-ai/kin-search)** | लेक्सिकल खोज प्रिमिटिव और स्टेज्ड रिट्रीवल। |
| **[kin-vector](https://github.com/firelock-ai/kin-vector)** | वेक्टर और निकटतम-पड़ोसी सब्सट्रेट। |
| **[kin-infer](https://github.com/firelock-ai/kin-infer)** | इन्फ़रेंस और एम्बेडिंग सब्सट्रेट। |
| **[kin-lsp](https://github.com/firelock-ai/kin-lsp)** | लैंग्वेज-सर्वर संवर्धन जो सिमेंटिक परत को फ़ीड करता है। |

ये एक ही सिस्टम की कार्यान्वयन परतें हैं, अलग-अलग उत्पाद नहीं जिन्हें नए उपयोगकर्ता
को जोड़ना पड़े। इनमें से कोई भी अलग से इंस्टॉल नहीं होता।

## ओपन सोर्स और Kin इकोसिस्टम

Kin का मूल Apache-2.0 के तहत ओपन सोर्स है: [kin](https://github.com/firelock-ai/kin),
[kin-db](https://github.com/firelock-ai/kin-db), [kin-vfs](https://github.com/firelock-ai/kin-vfs),
और [kin-editor](https://github.com/firelock-ai/kin-editor), साथ ही सहायक
लाइब्रेरीज़ kin-model, kin-blobs, kin-search, kin-vector, kin-infer, kin-lsp, और
kin-actions।

[KinLab](https://kinlab.ai) इस ओपन कोर पर बना एक मालिकाना उत्पाद है: ऊपर वर्णित
होस्टेड सहयोग और कंट्रोल-प्लेन परत।

वही सीमा बेंचमार्क कार्य साझा करने के तरीके पर भी लागू होती है। [बेंचमार्क
विनिर्देश और एक स्टैंडअलोन, डिपेंडेंसी-मुक्त बंडल वेरिफ़ायर](https://github.com/firelock-ai/kin-bench-spec)
सार्वजनिक हैं, ताकि किसी दावे को उस सिस्टम तक पहुँच के बिना जाँचा जा सके जिसने उसे
तैयार किया। सीलबंद साक्ष्य बंडल उत्पन्न करने वाला रनर और प्रूफ़ इंफ्रास्ट्रक्चर (ऑर्केस्ट्रेशन,
पिन्ड-रिलीज़ प्रूफ़ गेट, और होस्टेड मापन वातावरण) अभी के लिए निजी रहते हैं। विनिर्देश और
वेरिफ़ायर पहले खुलते हैं; रनर बाद में खुल सकता है।

## सबसे छोटा ग्राफ़-समर्थित रास्ता

पाँच कमांड, और आखिरी वाला ही उत्तर है:```sh
curl -fsSL https://get.kinlab.dev/install | sh
exec "$SHELL" -l
cd /path/to/your/repository
kin init .
kin locate "where are webhook retries handled"

kin init धीमा कदम है और वही है जो बाकी सब कुछ संभव बनाता है। यह आपके Git इतिहास को ग्राफ में शामिल करता है, और उसके बाद हर उत्तर उसी ग्राफ से आता है, न कि ट्री को दोबारा पढ़ने से। एक नए Debian 12 कंटेनर पर 4 CPUs और 8 GiB के साथ, जो रिलीज़ npm आज परोसता है, उस पर मापा गया, इंस्टॉलर ने 4 सेकंड लिए, kin init ने 503-फ़ाइल रिपॉजिटरी पर 1,983 कमिट्स के साथ 139 सेकंड लिए, और पहला kin locate 6.7 सेकंड में उत्तर दिया जबकि डेमॉन कोल्ड-स्टार्ट हो रहा था, फिर 71 मिलीसेकंड में वार्म। ये एक ही बैठक के अलग-अलग मापे गए चरण हैं, एक समयबद्ध रन नहीं, और गहरे इतिहास वाली रिपॉजिटरी में अधिक समय लगता है।

अपने एजेंट को kin init के बाद जोड़ें, पहले नहीं। इस अनुभाग का बाकी हिस्सा वही रास्ता है जिसमें हर कदम के पीछे का विवरण है।

1. Kin इंस्टॉल और कॉन्फ़िगर करें

macOS या Linux पर:```sh curl -fsSL https://get.kinlab.dev/install | sh exec "$SHELL" -l kin setup --intent agent

`kin setup --intent editor` का उपयोग VS Code पथ के लिए करें। परिणामी
मशीन-पठनीय स्वास्थ्य जाँच सूची की पुष्टि `kin setup status --json` से करें।

इंस्टॉलर [नवीनतम स्थिर रिलीज़](https://github.com/firelock-ai/kin/releases/latest) को हल करता है,
इसके प्रकाशित SHA-256 चेकसम को सत्यापित करता है, प्रबंधित बाइनरी को
`~/.kin` के अंतर्गत स्थापित करता है, और सेटअप लॉन्च करता है। स्पष्ट `agent` इंटेंट चलाने से
पता लगाए गए समर्थित क्लाइंटों के लिए अंतर्निहित MCP सर्वर कॉन्फ़िगर होता है। MCP कॉन्फ़िगरेशन के बिना
CLI और फ़ाइलसिस्टम उपयोग के लिए `--intent local` का उपयोग करें, या VS
Code पथ के लिए `--intent editor` का उपयोग करें।

केवल सेटअप-प्रबंधित एकीकरण हटाने के लिए, `kin setup uninstall` चलाएँ। डिफ़ॉल्ट
प्रबंधित रूट (`~/.kin`) के लिए, `kin setup uninstall --all` सभी Kin
डेमन को भी रोकता है, पुराने लीगेसी इंस्टॉलर PATH ब्लॉक हटाता है, और प्रबंधित
इंस्टॉल को पुनरावर्ती रूप से हटाता है (`--dry-run` इसका पूर्वावलोकन करता है)। एक कस्टम `KIN_HOME` कभी भी
पुनरावर्ती रूप से नहीं हटाया जाता: पहले लेज़र-स्कोप्ड अनइंस्टॉल चलाएँ, फिर उस निर्देशिका की समीक्षा करें और उसे स्पष्ट रूप से हटाएँ। संशोधित सेटअप-स्वामित्व वाले स्लाइस पूर्ण निष्कासन को रोकते हैं जब तक कि आप
`--force` न जोड़ें, इसलिए अनइंस्टॉल कभी भी उपयोगकर्ता के संपादित क्लाइंट या
शेल कॉन्फ़िगरेशन को चुपचाप अधिलेखित नहीं करता। Windows पर, CLI अपनी लॉक की गई इंस्टॉल निर्देशिका को
चल रही प्रक्रिया के बाहर निकलने के तुरंत बाद हटाने के लिए शेड्यूल करता है। Windows जानबूझकर
एक निष्क्रिय, केवल-वर्तमान-उपयोगकर्ता वाला सहोदर प्राधिकरण साइडकार बनाए रखता है; उस लॉक
पहचान को स्थिर रखने से क्रैश या समवर्ती भविष्य की इंस्टॉल को दो स्वतंत्र म्यूटेशन
प्राधिकरण बनाने से रोका जा सकता है। CLI और JSON परिणाम शून्य अवशिष्ट बाइट्स का दावा करने के बजाय इस बनाए रखे गए समन्वय
मेटाडेटा का खुलासा करते हैं।

मैन्युअल इंस्टॉलेशन के लिए, प्रत्येक संग्रह और उसकी `.sha256` फ़ाइल
`https://github.com/firelock-ai/kin/releases/latest/download/` के अंतर्गत प्रकाशित होती है। गतिशील एसेट
नाम हैं `kin-macos-aarch64`, `kin-macos-x86_64`, `kin-linux-aarch64`,
`kin-linux-x86_64`, और `kin-windows-x86_64`; macOS और Linux संग्रहों के लिए `.tar.gz` सफ़िक्स और
Windows के लिए `.zip` सफ़िक्स का उपयोग करें, जैसा कि
नवीनतम रिलीज़ पृष्ठ पर दिखाया गया है। Windows zip वही है जो PowerShell इंस्टॉलर और
npm लॉन्चर लाते हैं।

npm प्रवेश बिंदु उसी सार्वजनिक रिलीज़ चैनल को हल करता है:```sh
npm install -g @kinlab/kin@latest

वैश्विक इंस्टॉल के लिए एक लिखने योग्य npm prefix की आवश्यकता होती है। जहाँ prefix root के स्वामित्व में है और आप root नहीं हैं, वहाँ npm EACCES: permission denied, mkdir '/usr/local/lib/node_modules/@kinlab' के साथ मना कर देता है, इससे पहले कि Kin बिल्कुल चले, जो कि एक कंटेनर के अंदर सामान्य स्थिति है जिसका डिफ़ॉल्ट उपयोगकर्ता root नहीं है। या तो zero-install पथ का उपयोग करें, npx -y @kinlab/kin setup --intent agent --no-interactive, या prefix को किसी ऐसी जगह ले जाएँ जिसके आप स्वामी हों और उसे अपने PATH पर रखें:```sh npm config set prefix ~/.npm-global export PATH="$HOME/.npm-global/bin:$PATH" # add this to your shell profile too npm install -g @kinlab/kin@latest

आपके इंटरैक्टिव शेल के `PATH` पर एक उपयोगकर्ता प्रीफ़िक्स है और कहीं और नहीं। स्क्रिप्ट, CI चरण,
`docker exec`, और एजेंट क्लाइंट इसे इनहेरिट नहीं करते हैं, इसलिए उन्हें बेयर `kin` के बजाय बाइनरी का पूर्ण पथ दें। देखें
[आपके एजेंट के साथ काम करता है](#works-with-your-agent) पंजीकरण के स्वरूप के लिए।

एक Homebrew tap उसी रिलीज़ चैनल को ट्रैक करता है:```sh
brew install firelock-ai/kin/kin

टैप का फॉर्मूला हाथ से बनाए रखने के बजाय जनरेट किया जाता है। इसका संस्करण और इसका प्रति-प्लेटफ़ॉर्म SHA-256 प्रत्येक Kin रिलीज़ से टैप रिपॉजिटरी में update-formula.yml द्वारा पुनर्जनरेट किया जाता है, जो रिलीज़ स्वयं भेजे गए डिस्पैच पर होता है, छह-घंटे के समाधान के साथ जो छूटे हुए को स्वयं-ठीक करता है। इसीलिए Homebrew जिस चेकसम को सत्यापित करता है वह आर्काइव के साथ प्रकाशित होता है, न कि उसकी अलग से क्यूरेट की गई प्रति। kin --version के साथ सत्यापित करें कि आपने क्या इंस्टॉल किया है, जैसा कि आपको किसी भी इंस्टॉल पथ पर करना चाहिए।

Windows पर, PowerShell में irm https://get.kinlab.dev/install.ps1 | iex चलाएँ। नेटिव Windows x86_64 समर्थन प्रारंभिक है। रिपॉजिटरी प्रवेश कार्य करता है: kin init एक Git रिपॉजिटरी आयात करता है और ग्राफ अधिकार प्रकाशित करता है, और ग्राफ, लेक्सिकल, और डेमॉन-समर्थित क्वेरीज़ नेटिव रूप से उत्तर देती हैं। पारदर्शी फ़ाइलसिस्टम प्रोजेक्शन Windows पर शिप नहीं किया गया है, और एंड-टू-एंड इंस्टॉल प्रमाण अभी तक वहाँ MCP या समीक्षा वर्कफ़्लो को कवर नहीं करता है, इसलिए पूर्ण Kin अनुभव के लिए WSL2 अनुशंसित पथ बना हुआ है। Windows इंस्टॉल पथ चुनने से पहले नीचे प्लेटफ़ॉर्म और परिपक्वता पढ़ें।

2. किसी मौजूदा रिपॉजिटरी को ग्राफ सत्य के रूप में स्वीकार करें```sh

cd /path/to/your/repository kin init .

एक पहचाने गए Git रिपॉजिटरी में, `kin init` परमाणु रूप से पूर्ण पहुंच योग्य इतिहास, refs, कच्ची वस्तुओं, सटीक वर्कट्री, और प्रवेश नीति को repository-v6 ग्राफ प्राधिकरण में स्वीकार करता है। अप्रतिबद्ध संपादनों, staged परिवर्तनों, या अनट्रैक्ड फ़ाइलों वाला एक वर्कट्री फिर भी स्वीकार करता है: `kin init` प्रतिबद्ध स्थिति को स्वीकार करता है और बताता है कि उसने क्या स्वीकार नहीं किया। यह कभी भी एक सटीक-HEAD स्नैपशॉट या कच्चे-फाइलसिस्टम सिमेंटिक पुनर्निर्माण का विकल्प नहीं देता। समर्थित रिपॉजिटरी-स्थानीय रिमोट URL, refspecs, ब्रांच ट्रैकिंग, और push डिफ़ॉल्ट Kin की Git सह-अस्तित्व कॉन्फ़िगरेशन में सील कर दिए जाते हैं; असुरक्षित, अस्पष्ट, या असमर्थित ट्रांसफर सेटिंग्स प्रकाशन से पहले fail closed हो जाती हैं।

प्रवेश उस इतिहास में प्रत्येक समर्थित entity-source फ़ाइल के लिए सिमेंटिक entity और relation परत भी प्राप्त करता है, और `kin init` उन स्थायी, generation-बद्ध गणनाओं की रिपोर्ट करता है जिन्हें उसने प्रतिबद्ध किया। `kin status` उस रिपॉजिटरी प्राधिकरण दृश्य की रिपोर्ट करता है; `kin graph status` अलग से डेमन के परिवर्तनशील लाइव क्वेरी ग्राफ की रिपोर्ट करता है, जिसमें बाद में प्राप्त संवर्धन शामिल हो सकता है।
क्वेरी सतहें ग्राफ-स्वामित्व वाले संवर्धन का उपयोग करती हैं जब वह मौजूद होता है और उसकी अनुपस्थिति की रिपोर्ट करती हैं, बजाय कच्ची फ़ाइल खोज के पीछे अंतर छिपाने के।

#### कौन सी फ़ाइलें entities बनती हैं

"समर्थित entity-source फ़ाइल" का अर्थ है एक फ़ाइल जिसे Kin के भाषा एडेप्टर में से एक दावा करता है। एडेप्टर रजिस्ट्री पूरा सेट है, और रिपॉजिटरी में हर फ़ाइल इसके माध्यम से हल होती है:

| भाषा | एक्सटेंशन |
| --- | --- |
| TypeScript | `.ts`, `.tsx` |
| JavaScript | `.js`, `.jsx`, `.mjs`, `.cjs` |
| Python | `.py`, `.pyi` |
| Go | `.go` |
| Java | `.java` |
| Rust | `.rs` |
| C | `.c`, `.h` |
| C++ | `.cpp`, `.hpp`, `.cc`, `.cxx` |
| C# | `.cs` |
| Ruby | `.rb` |
| PHP | `.php` |
| Swift | `.swift` |
| Kotlin | `.kt`, `.kts` |
| HCL / Terraform | `.tf`, `.tfvars` |

एक `.h` हेडर को C++ के रूप में पढ़ा जाता है जब उसकी सामग्री ऐसा कहती है, इसलिए एक C++ प्रोजेक्ट नेमस्पेस और टेम्पलेट्स को C व्याकरण में नहीं खोता।

बाकी सब कुछ सामग्री के रूप में स्वीकार किया जाता है और इतिहास और पाठ के रूप में क्वेरी करने योग्य रहता है, लेकिन entities और relations में पार्स नहीं किया जाता। इसमें Markdown, HTML और CSS, SQL, YAML, JSON और TOML, शेल स्क्रिप्ट, Objective-C, Scala, Elixir, Dart, Lua, R, Zig, Haskell, और Nix शामिल हैं। यदि आपकी भाषा उस सूची में है, तो `locate` और `refs` उसमें प्रतीक नहीं खोजेंगे।

### 3. ग्राफ से एक वास्तविक प्रश्न पूछें```sh
kin locate "where are webhook retries handled"
kin refs ExactEntityName
kin trace ExactEntityName
kin overview

ExactEntityName को locate द्वारा लौटाए गए प्रतीक से बदलें। locate किसी इरादे से संबंधित इकाइयों को ढूंढता है, refs ग्राफ-स्वामित्व वाले कॉलर्स/इम्पोर्टर्स और संदर्भों को दिखाता है, और trace फोकल इकाई के साथ-साथ आस-पास के सिमेंटिक संदर्भ को लौटाता है। एम्बेडिंग पूरी हो जाने पर, आपका कॉन्फ़िगर किया गया AI एजेंट वेक्टर-समर्थित semantic_locate टूल का उपयोग कर सकता है; get_context_pack, find_references, और trace_data_flow ग्राफ़ के पड़ोस को सीधे उजागर करते हैं।

Admission सिमेंटिक इकाइयों को प्राप्त करता है, उनके वेक्टरों को नहीं। उन पर स्थानीय वेक्टर समानता जोड़ने के लिए kin embed चलाएँ, और kin graph status के साथ कवरेज की पुष्टि करें।

आपके एजेंट के साथ काम करता है

Kin अपना स्वयं का एजेंट शिप करता है, और एजेंट कार्य के लिए यही वह मार्ग है जिसकी हम अनुशंसा करते हैं। kin agent run किसी भी OpenAI-संगत एंडपॉइंट को चलाता है, इसलिए LM Studio, Ollama, llama.cpp या vLLM में एक स्थानीय मॉडल होस्ट किए गए मॉडल के समान फ्लैग से काम करता है, और यह उसी MCP सर्वर के माध्यम से ग्राफ़ तक पहुँचता है जिसका उपयोग हर अन्य क्लाइंट करता है।```sh kin agent run --task "Find where the retry backoff is computed and document it"
--model qwen/qwen3.6-35b-a3b --base-url http://localhost:1234/v1

यह बात इसे MCP सर्वर पर किसी अन्य एजेंट को इंगित करने से अलग बनाती है कि
नियम एजेंट के अंदर लागू किया जाता है, न कि किसी विक्रेता की अनुमति परत से उधार लिया जाता है।
इसके पास Kin के टूल्स के साथ-साथ ठीक दो स्थानीय टूल हैं, `edit_file` और
`write_file`। कोई शेल, कोई grep और कोई फ़ाइल-पढ़ने वाला टूल नहीं है, इसलिए यह
कच्ची फ़ाइल खोज से किसी रिपॉज़िटरी प्रश्न का उत्तर नहीं दे सकता, और इसके द्वारा आविष्कृत कोई टूल
नाम से अस्वीकार कर दिया जाता है। जब Kin रिपोर्ट करता है कि किसी खाली परिणाम पर भरोसा नहीं किया जा सकता,
एजेंट को बताया जाता है कि उत्तर अज्ञात है और नामित अंतर दिया जाता है, बजाय यह निष्कर्ष निकालने के कि
वह चीज़ मौजूद नहीं है। हर संपादन Kin सत्र के अंतर्गत Kin ट्रांज़ैक्शन के अंदर चलता है,
इसलिए परिवर्तन में एजेंट का नाम बताने वाली प्रोवेनेंस होती है। पहले `kin agent doctor
--base-url <url>` चलाएँ ताकि दोनों हिस्से उत्तर दे रहे हैं या नहीं, यह जाँचा जा सके। देखें
[CLI संदर्भ](https://github.com/firelock-ai/kin/blob/main/docs/cli-reference.md#kin-agent) पूरी सतह के लिए।

Claude Code, Codex, Cursor, Gemini और किसी भी अन्य चीज़ के साथ काम करना जो MCP बोलता है,
पहली श्रेणी में रहता है। `kin setup --intent agent` हर उस क्लाइंट को कॉन्फ़िगर करता है जिसे यह पहचानता है
एक ही पास में। ये प्रति-क्लाइंट एक-लाइनर हैं जब आप Kin को सीधे इंस्टॉल करना पसंद करते हैं।

क्लाइंट को जोड़ने से पहले रिपॉज़िटरी में `kin init .` चलाएँ, बाद में नहीं। ये
टूल ग्राफ़ से उत्तर देते हैं, इसलिए किसी ऐसी डायरेक्टरी की ओर इंगित किया गया क्लाइंट जिसमें कोई ग्राफ़ नहीं है,
उसे ऐसी टूल सतह मिलती है जिसके पीछे कुछ भी नहीं होता। `kin setup` स्वयं यही कहता है: इसकी
राउंड-ट्रिप जाँच उस डायरेक्टरी के "ऊपर या उस पर कोई आरंभित Kin रिपॉज़िटरी नहीं" रिपोर्ट करती है
जिसमें यह चला, और आपको वहाँ `kin init` चलाने और setup को फिर से चलाने के लिए कहता है।

Claude Code, सत्र के अंदर से:```
/plugin marketplace add firelock-ai/kin
/plugin install kin@kin

कोडेक्स:```sh codex plugin marketplace add firelock-ai/kin codex plugin add kin@kin

Gemini CLI:```sh
gemini extensions install https://github.com/firelock-ai/kin

कर्सर एक-क्लिक इंस्टॉल लिंक लेता है। इसे कर्सर में या अपने ब्राउज़र के एड्रेस बार में पेस्ट करें:``` cursor://anysphere.cursor-deeplink/mcp/install?name=kin&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBraW5sYWIva2luIiwibWNwIiwic3RhcnQiXX0=

Kiro वेब लिंक के रूप में भी यही चीज़ लेता है:
[Add Kin to Kiro](https://kiro.dev/launch/mcp/add?name=kin&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22@kinlab%2Fkin%22%2C%22mcp%22%2C%22start%22%5D%7D).

Cline एक-लाइनर के बजाय नीचे दिया गया मानक एंट्री लेता है। इसका CLI
`~/.cline/mcp.json` पढ़ता है। VS Code एक्सटेंशन में, MCP Servers पैनल खोलें, फिर
Configure टैब, फिर Configure MCP Servers, और वहाँ एंट्री जोड़ें।

हर दूसरा क्लाइंट जो एक मानक MCP कॉन्फ़िग पढ़ता है, यह एंट्री लेता है:```json
{
  "mcpServers": {
    "kin": { "command": "npx", "args": ["-y", "@kinlab/kin", "mcp", "start"] }
  }
}

kin setup status और kin doctor इस सटीक आकार को पहचानते हैं, साथ ही उस absolute-path रूप को भी जिसे kin setup लिखता है, और बाकी किसी भी चीज़ को MISCONFIGURED के रूप में वर्गीकृत करते हैं। command को केवल kin तक छोटा न करें, क्योंकि agent clients आपके shell PATH को विश्वसनीय रूप से इनहेरिट नहीं करते। @kinlab/kin-mcp पुराना launcher है और उन configurations के लिए काम करता रहता है जो पहले से इसे नामित करती हैं; नई ones को @kinlab/kin की ओर इशारा करना चाहिए, जो पूर्ण CLI के एक mode के रूप में वही MCP server भेजता है।

wrapper को Node 20 या उससे नया चाहिए, और अपनी पहली run पर यह मेल खाते Kin release को डाउनलोड करता है, उसके प्रकाशित SHA-256 को सत्यापित करता है, और binaries को प्रति user cache करता है। Codex CLI को [mcp_servers.kin] के तहत TOML के समान ही चाहिए।

एक caveat जो दोहराने लायक है: ये tools graph से उत्तर देते हैं, इसलिए repository को kin init . के साथ admit और kin embed के साथ embed करना होता है, इससे पहले कि semantic_locate किसी भी चीज़ को rank कर सके। llms-install.md वह पूरा path है जो इस तरह लिखा गया है कि एक agent इसे बिना निगरानी के follow कर सके, एक bare machine से पहले verified tool call तक।

AI-लिखित बदलाव की समीक्षा करें

AI code लिखता है। Kin साबित करता है कि क्या बदला।

जिस branch की आप समीक्षा करना चाहते हैं उस पर kin init चलाएँ ताकि प्रासंगिक Git history graph में आ जाए, फिर report-only shadow gate को explicit commit SHA पास करें:```sh kin review shadow "$(git rev-parse main)..$(git rev-parse HEAD)"

परिणाम `PASS`, `NEEDS ATTENTION`, या `WOULD BLOCK` होता है, और इसके साथ ग्राफ से प्राप्त प्रभाव Kin, उसे ठीक करने के लिए आवश्यक संदर्भ, और दोनों के पीछे का साक्ष्य आता है। लेखकत्व घोषित किया जाता है, सत्यापित नहीं। कमांड आपके मर्ज को ब्लॉक नहीं करेगा या ग्राफ स्थिति नहीं बदलेगा। यह साक्ष्य किसी मानव या CI नीति को सौंपता है और वहीं रुक जाता है।

## Kin का Git से संबंध

आज Git के समानांतर। समय के साथ रिपॉजिटरी प्राधिकरण। ब्राउनफील्ड अपनाने के दौरान, Git एक स्पष्ट आयात/निर्यात अंतर-संचालनीयता सीमा बना रहता है; यह कभी भी Kin रनटाइम क्वेरी का उत्तर नहीं देता या लापता ग्राफ सत्य की मरम्मत नहीं करता।

- `kin init` पूर्ण पहुंच योग्य Git इतिहास और सटीक पैरेंट किनारों को आयात करता है। Kin में जानबूझकर कोई आंशिक-इतिहास या स्नैपशॉट-केवल आरंभीकरण मोड नहीं है।
- आयात के बाद, Kin का ग्राफ रिपॉजिटरी पहचान, ट्री स्थिति, इतिहास, refs, और शब्दार्थ संबंधों का स्वामी होता है। फाइलसिस्टम और Git दृश्य प्रक्षेपण हैं।
- `kin git export --output ../repo.git` एक ग्राफ-स्वामित्व वाली प्राधिकरण पीढ़ी से एक नया बेयर Git प्रक्षेपण लिखता है। यह कार्यशील फाइलों या आस-पास के `.git/` ऑब्जेक्ट स्टोर से परामर्श नहीं करता, और यह किसी मौजूदा या रिपॉजिटरी-आंतरिक गंतव्य को अस्वीकार करता है। ऑब्जेक्ट, refs, और निर्देशिकाएं no-replace गंतव्य प्रकाशन स्वीकार होने से पहले फ्लश की जाती हैं। क्षमता-एंकरित प्रकाशन वर्तमान में Unix होस्ट पर उपलब्ध है; अन्य होस्ट निर्यात बनाने से पहले अस्वीकार कर देते हैं।

यह एक टीम को मौजूदा रिपॉजिटरी को माइग्रेट करने देता है बिना अपने एडिटर, कंपाइलर, बिल्ड सिस्टम, या Git अंतर-संचालनीयता को छोड़े, जबकि Kin प्राधिकृत हो जाता है।

## प्लेटफ़ॉर्म और परिपक्वता

कोर रनटाइम और फाइलसिस्टम प्रक्षेपण के अलग-अलग समर्थन सीमाएं हैं:

| प्लेटफ़ॉर्म | कोर Kin रनटाइम | `kin-vfs` प्रक्षेपण |
| --- | --- | --- |
| macOS, Apple Silicon और Intel | नेटिव ग्राफ, वेक्टर, डेमन, सेटअप, MCP, और समीक्षा सतहें रिलीज़ आर्काइव में शामिल हैं। | दोनों आर्किटेक्चर पर भेजा और परीक्षित। यह `DYLD_INSERT_LIBRARIES` का उपयोग करता है; SIP-संरक्षित या हार्डन्ड प्रोग्राम इंजेक्शन को अस्वीकार कर सकते हैं। |
| Linux x86_64 और arm64 | `kin` और `kin-daemon` स्थिर musl बिल्ड हैं जो glibc और musl वितरणों पर चलने के लिए हैं। | सार्वजनिक VFS निष्पादन योग्य और shim GNU/glibc बिल्ड हैं, musl बिल्ड नहीं। वे 2.31 के पिन किए गए glibc फ्लोर के खिलाफ बनाए गए हैं और OpenSSL 3 से लिंक करते हैं, इसलिए प्रक्षेपण होस्ट को दोनों की आवश्यकता होती है; Debian 12 उन्हें लोड करता है, और Alpine और अन्य musl वितरण समर्थित प्रक्षेपण होस्ट नहीं हैं। रिलीज़ एक Linux आर्काइव प्रकाशित करने से इनकार करती है जिसके बाइनरी उस फ्लोर से अधिक glibc मांगते हैं। arm64 रिलीज़ प्रमाण Ubuntu 24.04 पर चलता है। |
| नेटिव Windows x86_64 | प्रारंभिक समर्थन: रिपॉजिटरी स्वीकार करती हैं और ग्राफ और लेक्सिकल क्वेरी नेटिव रूप से उत्तर देती हैं, लेकिन MCP और समीक्षा वर्कफ़्लो अभी तक इंस्टॉल प्रमाण द्वारा एंड-टू-एंड कवर नहीं हैं। पूर्ण Kin के लिए WSL2 अनुशंसित मार्ग बना हुआ है। | भेजा नहीं गया। प्रक्षेपण के लिए glibc सीमा को पूरा करने वाले Linux वितरण के साथ WSL2 का उपयोग करें। |

उपरोक्त प्रत्येक मामले में ग्राफ प्राधिकरण है। shim, एक NFS माउंट, एक FUSE माउंट, और Windows ProjFS उस सत्य को फाइलों के रूप में देखने के चार तरीके हैं, और Kin उनके बीच यह जांच कर चुनता है कि यह होस्ट क्या चला सकता है: एक माउंट जहां उपलब्ध हो, क्योंकि कर्नेल इसे सेवा देता है और कोई प्रक्रिया इसे छीन नहीं सकती, इंजेक्टेड shim के साथ macOS और Linux पर संगतता फॉलबैक के रूप में और ProjFS Windows पर अग्रणी, जहां कोई shim मौजूद नहीं है। `kin vfs on` चुने गए को सक्रिय करता है, `kin vfs off` इसे निष्क्रिय करता है, और `kin doctor` एक पंक्ति रखता है जो बताती है कि कौन सा प्रभाव में है और क्या यह काम कर रहा है। जहां एक मोड गायब है, Kin आपके प्लेटफ़ॉर्म के लिए इसे इंस्टॉल या सक्षम करने वाली सटीक पंक्ति प्रिंट करता है।
[docs/projection.md](https://github.com/firelock-ai/kin/blob/main/docs/projection.md) में पूर्ण प्रति-प्लेटफ़ॉर्म तालिका है।

पहला इंडेक्सिंग पूर्ण पहुंच योग्य Git इतिहास पढ़ता है, इसलिए बड़े या लंबे समय से चले आ रहे रिपॉजिटरी पर `kin init` एम्बेडिंग शुरू होने से पहले सेकंड नहीं, बल्कि मिनट लेता है। `init` लौटने के बाद, डेमन पृष्ठभूमि में तैयारी जारी रखता है, और बड़े रिपॉजिटरी पर पहले एजेंट कॉल उत्तर देने में काफी अधिक समय ले सकते हैं।

सीमित arm64 परीक्षण ने कोर ग्राफ और लेक्सिकल पथ को 512 MB पर उपयोग योग्य पाया, लेकिन पूर्ण एम्बेडिंग लगभग 522 MB मॉडल डाउनलोड करती है और वर्तमान में सुरक्षित संचालन फ्लोर के रूप में 2 GB की आवश्यकता होती है; 1 GB एक असुरक्षित किनारा है और 512 MB एम्बेडिंग के दौरान समाप्त हो सकता है। ये देखे गए अल्फा बाधाएं हैं, सार्वभौमिक आकार देने के वादे नहीं।

एक सफल `kin --version` केवल यह स्थापित करता है कि कोर बाइनरी चलती है। यह VFS संगतता या एक जीवित ग्राफ-समर्थित प्रक्षेपण स्थापित नहीं करता। एक समर्थित Unix होस्ट पर, `kin vfs status` का उपयोग करें, जो प्रत्येक प्रक्षेपण मोड की जांच करता है और प्रिंट करता है कि वास्तव में क्या प्रभाव में है, फिर `kin setup status` और एक वास्तविक `kin-vfs exec --workspace . -- <command>` लॉन्च। VFS लॉन्चर में एक इंटरपोज़िशन कैनरी शामिल है और रिपोर्ट करता है जब ऑपरेटिंग सिस्टम shim को छीन लेता है।
[kin-vfs README](https://github.com/firelock-ai/kin-vfs#current-platform-and-package-boundaries) में पूर्ण सीमा है।

रिलीज़ एसेट चेकसम-प्रकाशित हैं और रिलीज़ वर्कफ़्लो अपने समर्थित रनर मैट्रिक्स में अनाम इंस्टॉलेशन, डेमन/MCP, एम्बेडिंग, और वास्तविक ग्राफ-समर्थित VFS प्रक्षेपण जांच चलाता है। वर्कफ़्लो स्वयं सार्वजनिक है:
[Install Proof](https://github.com/firelock-ai/kin/actions/workflows/install-proof.yml). एक हरा रिलीज़ उन सटीक आर्टिफैक्ट्स और वातावरणों को स्थापित करता है; यह दावा नहीं है कि हर वितरण, उपकरण, या रिपॉजिटरी आकार पहले से कवर है।

## FAQ

### क्या Kin Git की जगह लेता है?

आज Git के समानांतर। समय के साथ रिपॉजिटरी प्राधिकरण। Git ब्राउनफील्ड अपनाने के दौरान एक स्पष्ट आयात/निर्यात अंतर-संचालनीयता सीमा बना रहता है, इसलिए एक टीम मौजूदा रिपॉजिटरी को माइग्रेट कर सकती है बिना अपने एडिटर, कंपाइलर, बिल्ड सिस्टम, या Git अंतर-संचालनीयता को छोड़े।

### क्या मेरा कोड मेरी मशीन छोड़ता है?

Kin स्थानीय रिपॉजिटरी कार्य को आपके वातावरण में रखता है, इसलिए रिपॉजिटरी इंजेशन, ग्राफ स्टोरेज, और स्थानीय क्वेरी सभी वहीं चलते हैं। KinLab एक अलग उत्पाद है जो स्पष्ट पहुंच और प्रारंभिक-पहुंच समझौतों के तहत होस्टेड सहयोग जोड़ता है।

### यह किन एजेंटों के साथ काम करता है?

Claude Code, Codex, Cursor, Gemini और किसी भी अन्य चीज़ के साथ काम करना जो MCP बोलता है, प्रथम श्रेणी बना रहता है। `kin setup --intent agent` एक पास में हर क्लाइंट को कॉन्फ़िगर करता है जिसे यह पहचानता है।

### क्या यह मर्ज को ब्लॉक करता है?

समीक्षा सलाहकारी है, इसलिए यह बिना ब्लॉक किए जोखिम को चिह्नित करती है और मर्ज निर्णय आपकी टीम के पास रहता है। `kin review shadow` साक्ष्य किसी मानव या CI नीति को सौंपता है और वहीं रुक जाता है।

## प्रमाण मुद्रा

प्रकाशित पूर्व-पंजीकृत Multi-SWE-Bench Go प्रमाण पैकेज एक पुराने बिल्ड से जुड़ा है, चल रहे नवीनतम रिलीज़ से नहीं, और यह एक व्यापक गति, टोकन-बचत, या श्रेणी-जीत दावा स्थापित नहीं करता। तुलनात्मक परिणाम स्वतंत्र सत्यापन की प्रतीक्षा में यहां रोके गए हैं।

कार्यप्रणाली, कार्य सेट, बिल्ड पहचान, और आर्टिफैक्ट्स को
[सार्वजनिक प्रमाण पैकेज](https://firelock.ai/labs/kin-proof) में पढ़ें। उस मापे गए दायरे से बाहर के दावों को परिकल्पना मानें जब तक उनके पास अपना स्वयं का प्रतिलिपि योग्य प्रमाण न हो।

## लेखन

Kin बनाने से इंजीनियरिंग नोट्स, जो लिखे गए हैं ताकि एक अजनबी उन्हें पुनः उपयोग कर सके,
[kinlab.ai/blog](https://kinlab.ai/blog) पर रहते हैं, फ़ीड के साथ
[kinlab.ai/rss.xml](https://kinlab.ai/rss.xml) पर।

- [वह जांच जो पास हुई क्योंकि उसने कुछ नहीं मापा](https://kinlab.ai/blog/checks-that-cannot-fail)
- [आपकी कोड खोज कहती है कि कोई इसका उपयोग नहीं करता। क्या आप इसे हटा सकते हैं?](https://kinlab.ai/blog/empty-answer-safe-to-delete)

## सीखें और योगदान करें

- [Quickstart और उन्नत कॉन्फ़िगरेशन](https://github.com/firelock-ai/kin/blob/main/docs/quickstart.md)
- [स्टोर आकार और इसे क्या चलाता है](https://github.com/firelock-ai/kin/blob/main/docs/store-size.md)
- [MCP टूल संदर्भ](https://github.com/firelock-ai/kin/blob/main/docs/mcp-tools.md)
- [भाषा समर्थन और प्रत्येक स्तर क्या निकालता है](https://github.com/firelock-ai/kin/blob/main/docs/language-support.md)
- [पर्यावरण चर संदर्भ](https://github.com/firelock-ai/kin/blob/main/docs/env-vars.md)
- [ग्राफ-प्रथम थीसिस](https://github.com/firelock-ai/kin/blob/main/docs/thesis.md)
- [लेखन-प्राधिकरण मॉडल और इसकी संक्रमणकालीन स्थिति](https://github.com/firelock-ai/kin/blob/main/docs/write-authority-model.md)
- [GitHub Discussions](https://github.com/firelock-ai/kin/discussions)
- [बग रिपोर्ट और फीचर अनुरोध](https://github.com/firelock-ai/kin/issues/new/choose)
- [योगदान मार्गदर्शिका](https://github.com/firelock-ai/kin/blob/main/CONTRIBUTING.md)
- [निजी सुरक्षा रिपोर्टिंग](https://github.com/firelock-ai/kin/blob/main/SECURITY.md)

## लाइसेंस

[Apache-2.0](https://github.com/firelock-ai/kin/blob/main/LICENSE).

<p align="center"><em>सॉफ्टवेयर जो खुद को याद रखता है।</em></p>