kin v0.7.20
Contrôle de version sémantique basé sur les graphes pour le code écrit par l'IA. Suit les entités et les relations au lieu des diffs de fichiers, permettant l'analyse du rayon d'impact, la revue de fusion fantôme et le contexte d'agent propulsé par MCP pour un logiciel généré par l'IA digne de confiance.
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.
Bêta publique. Essayez Kin sur un projet réel que vous connaissez bien. Attendez-vous à des aspérités.
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 clone frais d'un projet 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
Commencez dans un clone frais et complet d'un projet que vous connaissez bien. kin init lit votre historique Git sans le modifier ni modifier vos fichiers suivis. Il ajoute un répertoire .kin et une ligne à .git/info/exclude. L'import couvre chaque commit atteint par vos branches et tags, donc le temps, la mémoire et le disque augmentent avec l'historique plutôt qu'avec la taille du checkout. Avant de commencer, kin init vérifie la mémoire et l'espace disque libre et s'arrête avec les chiffres lorsqu'il peut déjà déterminer que la machine est à court. Les clones superficiels, les sous-modules et Git LFS ne sont pas pris en charge, et les hooks Git, un checkout sparse ou une fusion ou rebase inachevée arrêtent également l'import. kin init nomme la correction pour chacun, et un clone frais évite la plupart d'entre eux.
1. Installer
Sur macOS, Linux et WSL2, une seule commande installe Kin et connecte les outils de codage IA qu'il trouve. Elle 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 en tant que 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
Sur Windows x64 natif, installez depuis PowerShell avec irm https://get.kinlab.dev/install.ps1 | iex.
Cela installe la CLI kin et ne connecte pas les outils de codage IA, car WSL2 reste le
chemin recommandé sur Windows. L'entrée Windows sous Limites de la bêta
indique ce qui fonctionne là-bas. Aucune build Windows ARM64 native n'est publiée. Sur une machine ARM64, exécutez
cette ligne depuis PowerShell x64 pour installer la build x86_64 sous émulation, ou utilisez WSL2.
L'installateur ajoute kin à votre PATH utilisateur, donc ouvrez une nouvelle fenêtre PowerShell à la place de
exec "$SHELL" -l avant l'étape suivante.
Pour d'autres installateurs ou le dépannage, voir le démarrage rapide complet.
2. Initialiser le dépôt
À la nouvelle invite, clonez un dépôt avec Kin :
kin clone https://github.com/pallets/itsdangerous
Ou initialisez-en un que vous avez déjà, en remplaçant le chemin ci-dessous :
cd /path/to/your/repository &&
kin init . &&
kin overview &&
kin status
Les deux se terminent par la prochaine commande à exécuter, une question kin refs sur une fonction dans ce
dépôt. Ils connectent également Codex CLI et Grok CLI à celui-ci lorsque vous l'avez autorisé lors de la configuration,
car ces clients conservent une entrée qui nomme un dépôt.
Windows PowerShell 5.1 n'a pas de &&, donc sur Windows natif exécutez les mêmes commandes une à la
fois et arrêtez si l'une échoue :
cd C:\path\to\your\repository
kin init .
kin overview
kin status
kin overview montre les entités que Kin a importées. kin status montre ce qui a été admis et l'état de l'arbre de travail par rapport à celui-ci. 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.