kin v0.3.3

Une nouvelle fondation pour le code.

Kin est un dépôt de code natif-graphe pour les personnes et les agents IA. Il stocke le code source, les relations de code enregistrées et l'historique versionné en tant qu'état du dépôt. Le graphe est le modèle du dépôt, et non un index de recherche maintenu à côté d'un autre dépôt.

Les fonctions, les types et les relations entre eux sont des données que vous committez, branchez et fusionnez. Le code source exact est préservé octet par octet, et les projections de système de fichiers permettent aux outils pris en charge de continuer à fonctionner avec des fichiers ordinaires.

Alpha publique. Commencez par un petit dépôt que vous connaissez bien. Attendez-vous à des aspérités et à des changements cassants.

Démarrage rapide · Documentation · Démo navigateur

Une étoile aide d'autres personnes à trouver Kin, et les Discussions sont l'endroit où poser une question à son sujet.

Voir ce qui est connecté

Avant de modifier une fonction partagée, que devez-vous inspecter d'autre ? Kin vous permet de rechercher ses appelants enregistrés et d'explorer le code associé. La CLI et le serveur MCP interrogent le même graphe, afin que vous et votre agent puissiez travailler à partir du même enregistrement.

Enregistré sur un graphe ripgrep préparé à e89fff89ac9af12e8d4ce9d5fd07beb408ca730f. Les artefacts d'exécution bruts ne sont pas publics. Ceci illustre un flux de travail, pas un benchmark de performance.

Utilisez-le depuis Claude Code, Codex ou Cursor

Pour Claude Code :

/plugin marketplace add firelock-ai/kin
/plugin install kin@kin

Pour Codex, ajoutez le marketplace et installez le plugin, ou laissez kin setup --intent agent écrire le serveur MCP dans ~/.codex/config.toml pour vous.

Pour Cursor, ajoutez le serveur MCP manuellement ; voir plugins/kin-cursor pour l'extrait exact.

Après l'installation, exécutez kin init . dans un petit dépôt que vous connaissez bien ; la compétence kin-setup vous guide pour le reste.

Kin n'est pas publié sur crates.io. Le crate kin qui s'y trouve est un projet sans rapport.

Démarrage rapide

Utilisez une copie jetable d'un petit dépôt Git. L'importation inclut tout son historique accessible et peut prendre beaucoup de temps et de mémoire. Les clones superficiels, les sous-modules et Git LFS ne sont pas pris en charge.

1. Installer

Une seule commande, et elle est identique sur macOS, Linux, Windows et WSL. Elle installe Kin, connecte les outils de codage IA qu'elle trouve, et nécessite Node.js 20 ou plus récent :

npx -y @kinlab/kin setup

Sur une machine sans Node, exécutez plutôt l'installateur. get.kinlab.ai et get.kinlab.dev servent le même script :

curl -fsSL https://get.kinlab.dev/install | sh

Dans les deux cas, rechargez votre shell dans une commande séparée, car l'installation place kin dans ~/.kin/bin et ajoute ce répertoire à votre profil shell pour les nouvelles sessions :

exec "$SHELL" -l

Pour Windows PowerShell, d'autres installateurs ou le dépannage, voir le démarrage rapide complet.

2. Initialiser le dépôt

À la nouvelle invite, remplacez le chemin ci-dessous :

cd /path/to/your/repository &&
kin init . &&
kin overview &&
kin status

kin overview affiche les entités que Kin a importées. kin status affiche ce qui a été admis et l'état de l'arbre de travail par rapport à cela. kin graph status rapporte le graphe de requêtes en direct du démon et sa couverture. Les modifications non commitées et non suivies ne font pas partie de l'historique Git importé ; kin init rapporte ce qu'il a laissé de côté.

3. Posez une question que vous pouvez vérifier

Cherchez quelque chose que vous savez déjà être dans le code :

kin locate "<something you already know is in this repository>"

Remplacez ExactEntityName ci-dessous par un symbole issu du résultat :

kin refs ExactEntityName
kin trace ExactEntityName
kin impact ExactEntityName

refs renvoie les références enregistrées, trace apporte le contexte proche, et impact explore les effets potentiels à travers le graphe. Vérifiez les résultats par rapport au code source.

4. Connectez votre agent

Préparez les embeddings locaux, puis configurez les clients MCP détectés :

kin embed &&
kin setup --intent agent &&
kin setup status --json

Kin prend en charge Claude Code, Codex, Cursor, Gemini et d'autres clients MCP. Utilisez kin setup --intent editor pour VS Code. Kin inclut également kin agent run pour les points de terminaison de modèles compatibles OpenAI locaux ou hébergés.

Configuration du client · Outils MCP · Agent intégré

Les importations, le stockage et les requêtes locales s'exécutent sur votre machine. L'installation et le téléchargement initial du modèle d'embedding nécessitent un accès réseau. Avant que les embeddings ne soient prêts, kin locate utilise des signaux lexicaux et de graphe et rapporte la couverture vectorielle manquante.

Réviser un changement

Après avoir exécuté kin init sur la branche Git que vous souhaitez réviser, comparez des SHA de commit explicites par rapport à main :

kin review shadow "$(git rev-parse main)..$(git rev-parse HEAD)"

Le rapport renvoie PASS, NEEDS ATTENTION ou WOULD BLOCK, avec l'impact dérivé du graphe et les preuves à l'appui. Il est consultatif : il ne bloque pas une fusion ni ne modifie l'état du graphe. La paternité est déclarée, non vérifiée de manière indépendante.

Utilisez Kin avec ou sans Git

Kin possède ses propres commits, branches, fusions, diffs et historique, y compris dans des dépôts sans Git en dessous. Les dépôts Git existants peuvent être importés, et les flux de travail pris en charge peuvent exporter un nouveau dépôt Git.

Parcours de contrôle de version natif · Interopérabilité Git et limites d'export