kin v0.7.20
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.
Eine neue Grundlage für Code.
Kin ist ein graph-natives Code-Repository für Menschen und KI-Agenten. 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 committen, branchen und mergen kannst. Der exakte Quellcode bleibt Byte für Byte erhalten, und Dateisystem-Projektionen sorgen dafür, dass unterstützte Tools weiterhin mit gewöhnlichen Dateien arbeiten können.
Öffentliche Beta. Probiere Kin an einem echten Projekt aus, das du gut kennst. Rechne mit rauen Kanten.
Quickstart · Dokumentation · Browser-Demo
Ein Stern hilft anderen, Kin zu finden, und in den Discussions kannst du eine Frage dazu einbringen.
Sieh, was zusammenhängt
Bevor du eine geteilte 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.
Aufgezeichnet auf einem vorbereiteten ripgrep-Graphen bei e89fff89ac9af12e8d4ce9d5fd07beb408ca730f. Die rohen Lauf-Artefakte 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 firelock-ai/kin
/plugin install kin@kin
Für Codex füge den Marketplace hinzu und installiere das Plugin, oder lass kin setup --intent agent den MCP-Server für dich in ~/.codex/config.toml schreiben.
Für Cursor füge den MCP-Server manuell hinzu; siehe plugins/kin-cursor für das genaue Snippet.
Führe nach der Installation kin init . in einem frischen Clone eines Projekts aus, das du gut kennst; der kin-setup-Skill führt dich durch den Rest.
Kin ist nicht auf crates.io veröffentlicht. Das kin-Crate dort ist ein unabhängiges Projekt.
Quickstart
Beginne in einem frischen, vollständigen Clone eines Projekts, das du gut kennst. kin init liest deine Git-Historie, ohne sie oder deine getrackten Dateien zu verändern. Es fügt ein .kin-Verzeichnis und eine Zeile zu .git/info/exclude hinzu. Der Import umfasst jeden Commit, den deine Branches und Tags erreichen, sodass Zeit, Speicher und Festplattenplatz mit der Historie wachsen statt mit der Größe des Checkouts. Bevor er startet, prüft kin init Speicher und freien Festplattenplatz und bricht mit den Zahlen ab, wenn bereits erkennbar ist, dass die Maschine knapp ist. Shallow Clones, Submodule und Git LFS werden nicht unterstützt, und Git-Hooks, ein Sparse Checkout oder ein unvollendeter Merge oder Rebase stoppen den Import ebenfalls. 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 er findet. Er benötigt Node.js 20 oder neuer:
npx -y @kinlab/kin setup
Auf einer Maschine ohne Node führe stattdessen den Installer aus. get.kinlab.ai und get.kinlab.dev liefern dasselbe Skript aus:
curl -fsSL https://get.kinlab.dev/install | sh
Lade in beiden Fällen deine Shell als separaten Befehl neu, denn die Installation legt kin in ~/.kin/bin ab und fügt dieses Verzeichnis für neue Sitzungen zu deinem Shell-Profil hinzu:
exec "$SHELL" -l
Unter nativem Windows x64 installierst du aus PowerShell mit irm https://get.kinlab.dev/install.ps1 | iex. Das installiert die kin CLI und verbindet keine KI-Coding-Tools, denn WSL2 bleibt unter Windows der empfohlene Weg. Der Windows-Eintrag unter Beta-Grenzen sagt, was dort funktioniert. Es wird kein natives Windows-ARM64-Build veröffentlicht. Führe auf einer ARM64-Maschine diese Zeile aus x64-PowerShell aus, um das x86_64-Build unter Emulation zu installieren, oder verwende WSL2. Der Installer fügt kin zu deinem Benutzer-PATH hinzu, also öffne 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 Quickstart.
2. Repository initialisieren
Klone an der neuen Eingabeaufforderung ein Repository mit Kin:
kin clone https://github.com/pallets/itsdangerous
Oder initialisiere eines, das du bereits hast, und ersetze den Pfad unten:
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 im Setup erlaubt hast, denn diese Clients führen einen Eintrag, der ein Repository benennt.
Windows PowerShell 5.1 kennt kein &&, führe unter nativem Windows also dieselben Befehle einzeln aus und brich ab, wenn einer fehlschlägt:
cd C:\path\to\your\repository
kin init .
kin overview
kin status
kin overview zeigt die Entitäten, die Kin importiert hat. kin status zeigt, was aufgenommen wurde und wie der Zustand des Arbeitsverzeichnisses dazu steht. kin graph status meldet den Live-Abfragegraphen und die Abdeckung des Daemons. Nicht committete und nicht getrackte Änderungen sind nicht Teil der importierten Git-Historie; kin init meldet, was es ausgelassen hat.
3. Stelle eine Frage, die du überprüfen kannst
Suche nach etwas, von dem du bereits weißt, dass es im Code ist:
kin locate "<something you already know is in this repository>"
Ersetze ExactEntityName unten durch ein Symbol aus dem Ergebnis:
kin refs ExactEntityName
kin trace ExactEntityName
kin impact ExactEntityName
refs liefert aufgezeichnete Referenzen, trace bezieht nahen Kontext ein, und impact erkundet mögliche Auswirkungen durch den Graphen. Prüfe die Ergebnisse gegen den Quellcode.