kin v0.3.4
Das semantische System of Record für KI-geschriebene Software: ein Graph von Entitäten und Beziehungen, nicht Datei-Diffs.
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 Alpha. Beginne mit einem kleinen Repository, das du gut kennst. Rechne mit rauen Kanten und Breaking Changes.
Quickstart · Dokumentation · Browser-Demo
Ein Stern hilft anderen, Kin zu finden, und in den Discussions kannst du eine Frage dazu stellen.
Sieh, was zusammenhängt
Bevor du eine geteilte Funktion änderst: Was solltest du sonst noch prüfen? Kin lässt dich 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.
Aufgezeichnet auf einem vorbereiteten ripgrep-Graphen bei e89fff89ac9af12e8d4ce9d5fd07beb408ca730f. Rohe 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 exakte Snippet.
Führe nach der Installation kin init . in einem kleinen Repository 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
Verwende eine Wegwerf-Kopie eines kleinen Git-Repositories. Der Import umfasst seine vollständige erreichbare Historie und kann erhebliche Zeit und Speicher beanspruchen. Shallow Clones, Submodule und Git LFS werden nicht unterstützt.
1. Installation
Ein Befehl, und er ist derselbe unter macOS, Linux, Windows und WSL. Er installiert Kin, verbindet die gefundenen KI-Coding-Tools und 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 deinem Shell-Profil hinzu:
exec "$SHELL" -l
Für Windows PowerShell, andere Installer oder Fehlerbehebung siehe den vollständigen Quickstart.
2. Repository initialisieren
Ersetze an der neuen Eingabeaufforderung den Pfad unten:
cd /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 den Zustand des Arbeitsverzeichnisses dagegen. 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 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 potenzielle Auswirkungen durch den Graphen. Prüfe die Ergebnisse gegen den Quellcode.
4. Verbinde deinen Agenten
Bereite lokale Embeddings vor und konfiguriere dann erkannte MCP-Clients:
kin embed &&
kin setup --intent agent &&
kin setup status --json
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 · MCP-Tools · Integrierter Agent
Lokale Importe, Speicherung und Abfragen laufen auf deiner Maschine. Installation und der anfängliche Download des Embedding-Modells benötigen Netzwerkzugriff. Bevor Embeddings bereit sind, verwendet kin locate lexikalische und Graph-Signale und meldet die fehlende Vektor-Abdeckung.
Überprüfe eine Änderung
Nachdem du kin init auf dem Git-Branch ausgeführt hast, den du überprüfen möchtest, vergleiche explizite Commit-SHAs gegen main:
kin review shadow "$(git rev-parse main)..$(git rev-parse HEAD)"
Der Bericht liefert PASS, NEEDS ATTENTION oder WOULD BLOCK, mit graph-abgeleiteten Auswirkungen und unterstützenden Belegen. Er ist beratend: Er blockiert keinen Merge und ändert keinen Graph-Zustand. Die Urheberschaft wird angegeben, nicht unabhängig verifiziert.
Nutze Kin mit oder ohne Git
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 – Walkthrough · Git-Interoperabilität und Export-Grenzen