
Semantische graphbasierte Versionskontrolle für KI-geschriebenen Code. Verfolgt Entitäten und Beziehungen anstelle von Dateidiffs und ermöglicht Blast-Radius-Analyse, Shadow-Merge-Review und MCP-gestützten Agent-Kontext für vertrauenswürdige KI-generierte Software.
<p align="center"> <img src="https://assets.kitploit.com/production/public/readmes/12665/55686ad4696e166589300e948ce2ed89f45622266654371a433a31c612829ec8.png" alt="Kin, ein Code-Repository für KI-Agenten und die Menschen, die mit ihnen bauen" width="100%" /> </p> <h3 align="center">Eine neue Grundlage für Code.</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="Neueste Version" /></a> </p> **Kin ist ein graph-natives Code-Repository für KI-Agenten und die Menschen, die mit ihnen bauen.** Es speichert Quellcode, aufgezeichnete Code-Beziehungen und versionierte Historie als Repository-Zustand. Der Graph ist das Repository-Modell, kein Suchindex, der neben einem anderen Repository gepflegt wird. Funktionen, Typen und die Beziehungen zwischen ihnen sind Daten, die du committest, branchst und mergst. Der exakte Quellcode bleibt Byte für Byte erhalten, und Dateisystem-Projektionen sorgen dafür, dass unterstützte Werkzeuge weiterhin mit gewöhnlichen Dateien arbeiten können. **Öffentliche Beta.** Probiere Kin an einem echten Projekt aus, das du gut kennst. Rechne mit Ecken und Kanten. [Schnellstart](#quickstart) · [Dokumentation](https://github.com/firelock-ai/kin/blob/main/docs/quickstart.md) · [Browser-Demo](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, zeigt seine direkten Aufrufer in Kins eigener Codebasis neben einer git grep-Suche nach demselben Namen" width="100%" /> </p> Ein Stern hilft anderen, Kin zu finden, und in den [Diskussionen](https://github.com/kinlab-ai/kin/discussions) kannst du Fragen dazu stellen. ## Sieh, was zusammenhängt Bevor du eine gemeinsam genutzte Funktion änderst, was solltest du sonst noch prüfen? Mit Kin kannst du ihre aufgezeichneten Aufrufer nachschlagen und verwandten Code erkunden. Die CLI und der MCP-Server fragen denselben Graphen ab, sodass du und dein Agent mit derselben Aufzeichnung arbeiten können. <img src="https://assets.kitploit.com/production/public/readmes/12665/43f73477ba09d6aa7a5bb446cadaea9c36981cc1d093faacaa03b9b61346b955.png" alt="Eine aufgezeichnete kin impact-Abfrage zu ripgrep, die verwandte Entitäten für eine Signaturänderung zeigt" width="100%" /> *Aufgezeichnet auf einem vorbereiteten ripgrep-Graphen unter `e89fff89ac9af12e8d4ce9d5fd07beb408ca730f`. Die Rohartefakte des Laufs sind nicht öffentlich. Dies veranschaulicht einen Workflow, keinen Performance-Benchmark.* ## Nutze es aus Claude Code, Codex oder Cursor Für Claude Code: ``` /plugin marketplace add kinlab-ai/kin /plugin install kin@kin ``` Für [Codex](https://github.com/firelock-ai/kin/blob/main/plugins/kin-codex/README.md#install) fügst du den Marketplace hinzu und installierst das Plugin, oder du lässt `kin setup --intent agent` den MCP-Server für dich in `~/.codex/config.toml` schreiben. Für Cursor fügst du den MCP-Server manuell hinzu; den genauen Snippet findest du unter [plugins/kin-cursor](https://github.com/firelock-ai/kin/blob/main/plugins/kin-cursor/README.md#install). Nach der Installation führst du `kin init .` in einem frischen Clone eines Projekts aus, das du gut kennst; der Skill `kin-setup` führt dich durch den Rest. Kin ist nicht auf crates.io veröffentlicht. Das `kin`-Crate dort ist ein unabhängiges Projekt. ## Schnellstart Beginne in einem frischen, vollständigen Clone eines Projekts, das du gut kennst. `kin init` liest deine Git-Historie, ohne sie oder deine versionierten Dateien zu verändern. Es speichert seine Daten außerhalb deines Checkouts in `~/.kin/stores` und schreibt nichts in das Repository; `kin store path` gibt aus, wo der Store eines Checkouts liegt. Standardmäßig übernimmt es zuerst den ausgecheckten Commit, sodass Fragen beantwortet werden, sobald dieser Baum gelesen ist, und importiert dann im Hintergrund mit niedriger Priorität jeden Commit, den deine Branches und Tags erreichen; `kin init --history full` importiert die gesamte Historie im Voraus, und `--history none` importiert sie nie. Der Import der Historie beansprucht Zeit, Speicher und Festplattenplatz, die mit der Historie und nicht mit der Größe des Checkouts wachsen. Vor dem Start prüft `kin init` Speicher und freien Festplattenplatz und bricht mit den Zahlen ab, wenn bereits erkennbar ist, dass die Maschine knapp ist. **Ein Shallow Clone übernimmt nur seinen ausgecheckten Commit, und Submodule und Git LFS werden nicht unterstützt**, und auch Git-Hooks, ein Sparse Checkout oder ein unvollständiger Merge oder Rebase stoppen den Import. `kin init` nennt für jedes Problem die Lösung, und ein frischer Clone vermeidet die meisten davon. ### 1. Installation Unter macOS, Linux und WSL2 installiert ein einziger Befehl Kin und verbindet die KI-Coding-Tools, die es findet. Es benötigt Node.js 20 oder neuer: ```sh npx -y @kinlab/kin setup ``` Auf einem Rechner ohne Node führen Sie stattdessen den Installer aus. `get.kinlab.ai` und `get.kinlab.dev` liefern dasselbe Skript: ```sh curl -fsSL https://get.kinlab.dev/install | sh ``` Lade in jedem Fall deine Shell als separaten Befehl neu, da die Installation `kin` in `~/.kin/bin` ablegt und dieses Verzeichnis für neue Sitzungen zu deinem Shell-Profil hinzufügt: ```sh exec "$SHELL" -l ``` Unter nativem Windows x64 installieren Sie aus PowerShell mit `irm https://get.kinlab.dev/install.ps1 | iex`. Es installiert die `kin` CLI und verbindet keine KI-Coding-Tools, da WSL2 unter Windows weiterhin der empfohlene Weg bleibt. Der Windows-Eintrag unter [Beta-Grenzen](#beta-limits) beschreibt, was dort funktioniert. Es wird kein natives Windows-ARM64-Build veröffentlicht. Führen Sie auf einem ARM64-Rechner diese Zeile aus x64-PowerShell aus, um das x86_64-Build unter Emulation zu installieren, oder verwenden Sie WSL2. Der Installer fügt `kin` zu Ihrem Benutzer-PATH hinzu, öffnen Sie daher vor dem nächsten Schritt ein neues PowerShell-Fenster anstelle von `exec "$SHELL" -l`. Für andere Installer oder zur Fehlerbehebung siehe den [vollständigen Schnellstart](https://github.com/firelock-ai/kin/blob/main/docs/quickstart.md#1-install). ### 2. Repository initialisieren Klonen Sie an der neuen Eingabeaufforderung ein Repository mit Kin: ```sh kin clone https://github.com/pallets/itsdangerous ``` Oder initialisiere eine, die du bereits hast, und ersetze dabei den folgenden Pfad: ```sh cd /path/to/your/repository && kin init . && kin overview && kin status ``` Beide enden mit dem nächsten auszuführenden Befehl, einer `kin refs`-Frage zu einer Funktion in diesem Repository. Sie verbinden außerdem Codex CLI und Grok CLI damit, wenn du das bei der Einrichtung erlaubt hast, da diese Clients einen einzigen Eintrag behalten, der ein Repository benennt. Windows PowerShell 5.1 kennt kein `&&`, daher führe unter nativem Windows dieselben Befehle einzeln nacheinander aus und brich ab, wenn einer fehlschlägt: ```powershell cd C:\path\to\your\repository kin init . kin overview kin status ``` `kin overview` zeigt die von Kin importierten Entitäten. `kin status` zeigt, was aufgenommen wurde und welchen Zustand der Arbeitsbaum im Verhältnis dazu hat. `kin graph status` meldet den Live-Abfragegraphen und die Abdeckung des Daemons. Nicht committete und nicht verfolgte Änderungen sind nicht Teil der importierten Git-Historie; `kin init` meldet, was ausgelassen wurde. ### 3. Stelle eine Frage, die du überprüfen kannst Suche nach etwas, von dem du bereits weißt, dass es im Code enthalten ist: ```sh kin locate "<something you already know is in this repository>" ``` Ersetze `ExactEntityName` unten durch ein Symbol aus dem Ergebnis: ```sh kin refs ExactEntityName kin trace ExactEntityName kin impact ExactEntityName ``` `refs` gibt aufgezeichnete Referenzen zurück, `trace` bringt nahen Kontext ein und `impact` untersucht mögliche Auswirkungen über den Graphen. Prüfe die Ergebnisse gegen die Quelle. ### 4. Deine KI-Coding-Tools und semantische Suche `kin setup` hat bereits vor dem Verbinden der gefundenen KI-Coding-Tools nachgefragt und sie verbunden, wenn du zugestimmt hast. Es gibt keinen separaten Verknüpfungsschritt. Nachdem du ein weiteres Tool installiert hast, führe `kin setup` erneut aus, und `kin setup status` zeigt an, was verbunden ist. Unter Windows verbinde KI- Tools innerhalb von WSL2. `kin runtime status --json` prüft die gemeinsame CLI- und Daemon-Installation, einschließlich ihrer exakten Quellidentität. Normale Befehle lehnen nicht zueinander passende Paare ab; Entwicklungs- Builds verwenden isolierten Zustand. Siehe [runtime installation](https://github.com/firelock-ai/kin/blob/main/docs/runtime-installation.md). Graph- und lexikalische Abfrage funktionieren ohne ein Modell. Embeddings und Reranking sind optional, und ihre Modellanbieter sind standardmäßig auf `none` gesetzt. Standard-CLI- und Daemon-Builds enthalten Unterstützung für externe HTTP-Modelle. Integrierte Modelle erfordern einen Build mit aktivierter optionaler lokaler Inferenz. Um einen Embedding-Index mit einem von dir betriebenen OpenAI-kompatiblen Endpunkt zu erstellen: ```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 ``` Modell-Endpunkte erhalten den ausgewählten Entitätstext, der für ihre Stufe benötigt wird. [Modelleinstellungen](https://github.com/firelock-ai/kin/blob/main/docs/env-vars.md) beschreiben Anbieter, Modellidentitäten und Namen von Umgebungsvariablen für Anmeldedaten. Kin unterstützt Claude Code, Codex, Cursor, Gemini und andere MCP-Clients. Verwende `kin setup --intent editor` für VS Code. Kin enthält außerdem `kin agent run` für lokale oder gehostete OpenAI-kompatible Modell-Endpunkte. [Client-Konfiguration](https://github.com/firelock-ai/kin/blob/main/docs/readme-reference.md#works-with-your-agent) · [MCP-Tools](https://github.com/firelock-ai/kin/blob/main/docs/mcp-tools.md) · [Integrierter Agent](https://github.com/firelock-ai/kin/blob/main/docs/cli-reference.md#kin-agent) Lokale Importe, Speicherung und Graph-Abfragen laufen auf deiner Maschine. Die Installation von Kin erfordert Netzwerkzugriff; der standardmäßige Graph-Abrufpfad benötigt keinen Modell-Download. Wenn ein Embedding-Anbieter ausgewählt ist, melden Abfragen dessen Vektorabdeckung und etwaige Lücken. ## Eine Änderung überprüfen Nachdem du `kin init` auf dem Git-Branch ausgeführt hast, den du überprüfen möchtest, vergleiche explizite Commit-SHAs mit `main`: ```sh kin review shadow "$(git rev-parse main)..$(git rev-parse HEAD)" ``` Der Bericht liefert `PASS`, `NEEDS ATTENTION` oder `WOULD BLOCK`, mit aus dem Graphen abgeleiteter Auswirkung und unterstützenden Belegen. **Er ist beratend:** Er blockiert keinen Merge und ändert keinen Graphzustand. Die Urheberschaft wird erklärt, nicht unabhängig verifiziert. ## Kin mit oder ohne Git verwenden Kin hat eigene Commits, Branches, Merges, Diffs und Historie, auch in Repositories ohne Git darunter. Bestehende Git-Repositories können importiert werden, und unterstützte Workflows können ein neues Git-Repository exportieren. [Native Versionskontrolle – Anleitung](https://github.com/firelock-ai/kin/blob/main/docs/readme-reference.md#version-control-without-git) · [Git-Interoperabilität und Exportgrenzen](https://github.com/firelock-ai/kin/blob/main/docs/readme-reference.md#how-kin-relates-to-git) ## Beta-Grenzen **Die Abdeckung ist unvollständig.** Unterstützte Sprachen werden in Entitäten und Beziehungen geparst; andere Dateien bleiben als Inhalt und Historie verfügbar. Ein leeres Ergebnis beweist nicht, dass es keine Aufrufer oder Abhängigkeiten gibt. Verwenden Sie weiterhin Ihren Compiler, Ihre Tests und Ihr Review. Siehe [Sprachunterstützung](https://github.com/firelock-ai/kin/blob/main/docs/language-support.md). **Die Kompatibilität variiert.** Release-Archive enthalten nicht die veraltete `kin-vfs`-Dateisystemprojektion, sodass es keine transparente Projektion gibt, auf die man sich verlassen kann. Prüfen Sie die [Plattformhinweise](https://github.com/firelock-ai/kin/blob/main/docs/readme-reference.md#platform-and-maturity) für die Unterstützung der jeweiligen Plattform. **Sichern Sie Kin-spezifischen Zustand.** Commits, Branches, Reviews und Specs, die Sie mit Kin aufzeichnen, liegen im Kin-Store des Repositories, nicht in Git. Das Löschen des Stores und erneutes Importieren aus Git stellt sie nicht wieder her, führen Sie daher zuerst `kin backup create` aus. `kin store prune` löscht Stores nur, wenn Sie `--yes` übergeben, aus demselben Grund. Lesen Sie die [Hinweise zu Import, Wiederherstellung und Upgrade](https://github.com/firelock-ai/kin/blob/main/docs/readme-reference.md#what-is-real-today-and-what-is-beta). **Windows.** Die native Windows-x86_64-Unterstützung ist früh. Die Repository-Aufnahme funktioniert: `kin init` importiert ein Git-Repository und veröffentlicht die Graph-Autorität, und Graph-, lexikalische und daemon-gestützte Abfragen antworten nativ. Der End-to-End-Installationsnachweis führt außerdem die Agent-Einrichtung unter nativem Windows aus und erhält graph-gestützte Antworten vom installierten MCP-Server. Die transparente Dateisystemprojektion wird unter Windows nicht ausgeliefert, und Review-Workflows sind dort noch nicht getestet, daher bleibt WSL2 der empfohlene Weg für das vollständige Kin-Erlebnis. ## Warum ich Kin gebaut habe Ich sah immer wieder zu, wie Coding-Agenten Teile einer Codebasis zusammensetzten, die wir bereits durchgearbeitet hatten. Dann machte ich selbst eine Variante dieser Arbeit, um ihre Änderungen zu prüfen. Ich begann mich zu fragen, warum nicht mehr von diesem strukturellen Verständnis Teil des Repositories selbst war. Das ist es, was ich mit Kin baue. Troy ## Mehr erfahren und beitragen [CLI-Referenz](https://github.com/firelock-ai/kin/blob/main/docs/cli-reference.md) · [Architektur und detaillierte Grenzen](https://github.com/firelock-ai/kin/blob/main/docs/readme-reference.md) · [Mitwirken](https://github.com/firelock-ai/kin/blob/main/CONTRIBUTING.md) · [Issues](https://github.com/kinlab-ai/kin/issues/new/choose) · [Sicherheit](https://github.com/firelock-ai/kin/blob/main/SECURITY.md) Kin und sein lokaler Stack, einschließlich [kin-db](https://github.com/kinlab-ai/kin-db), stehen unter [Apache-2.0](https://github.com/firelock-ai/kin/blob/main/LICENSE). [KinLab](https://kinlab.ai) ist das separate proprietäre gehostete Produkt. Das Onboarding für das öffentliche Repository befindet sich noch in Entwicklung.
Entdecken Sie die meistgenutzten Tools unserer Community.
Noch keine Beliebtheitsdaten.