kin v0.4.8

Una nuova base per il codice.

Kin è un repository di codice nativo a grafo per agenti AI e per le persone che costruiscono con loro. Memorizza il codice sorgente, le relazioni tra codice registrate e la cronologia versionata come stato del repository. Il grafo è il modello del repository, non un indice di ricerca mantenuto accanto a un altro repository.

Funzioni, tipi e le relazioni tra essi sono dati che puoi committare, ramificare e unire. Il codice sorgente esatto è preservato byte per byte, e le proiezioni del filesystem permettono agli strumenti supportati di continuare a funzionare con file ordinari.

Beta pubblica. Prova Kin su un progetto reale che conosci bene. Aspettati qualche asperità.

Avvio rapido · Documentazione · Demo nel browser

Una stella aiuta altre persone a trovare Kin, e le Discussioni sono il luogo dove porre domande al riguardo.

Scopri cosa è connesso

Prima di modificare una funzione condivisa, cos'altro dovresti ispezionare? Kin ti permette di cercare i suoi chiamanti registrati ed esplorare il codice correlato. La CLI e il server MCP interrogano lo stesso grafo, così tu e il tuo agente potete lavorare dallo stesso registro.

Registrato su un grafo ripgrep preparato a e89fff89ac9af12e8d4ce9d5fd07beb408ca730f. Gli artefatti grezzi dell'esecuzione non sono pubblici. Questo illustra un flusso di lavoro, non un benchmark di prestazioni.

Usalo da Claude Code, Codex o Cursor

Per Claude Code:

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

Per Codex, aggiungi il marketplace e installa il plugin, oppure lascia che kin setup --intent agent scriva il server MCP in ~/.codex/config.toml per te.

Per Cursor, aggiungi il server MCP manualmente; consulta plugins/kin-cursor per lo snippet esatto.

Dopo l'installazione, esegui kin init . in un clone nuovo di un progetto che conosci bene; la skill kin-setup ti guida attraverso il resto.

Kin non è pubblicato su crates.io. Il crate kin presente lì è un progetto non correlato.

Avvio rapido

Inizia in un clone nuovo e completo di un progetto che conosci bene. kin init legge la tua cronologia Git senza modificarla né modificare i tuoi file tracciati. Mantiene il suo archivio fuori dal tuo checkout, in ~/.kin/stores, e non scrive nulla nel repository; kin store path stampa dove si trova l'archivio di un checkout. Per impostazione predefinita ammette prima il commit estratto, così le domande ricevono risposta non appena quell'albero è letto, e poi importa in background ogni commit raggiunto dai tuoi branch e tag, a bassa priorità; kin init --history full importa l'intera cronologia in anticipo, mentre --history none non la importa mai. L'importazione della cronologia richiede tempo, memoria e spazio su disco che crescono con la cronologia anziché con la dimensione del checkout. Prima di iniziare, kin init controlla la memoria e lo spazio libero su disco e si ferma mostrando i numeri quando può già stabilire che la macchina è a corto di risorse. Un clone shallow ammette solo il suo commit estratto, e i submodule e Git LFS non sono supportati, inoltre gli hook Git, uno sparse checkout o un merge o rebase incompleto bloccano anch'essi l'importazione. kin init indica la soluzione per ciascuno, e un clone nuovo evita la maggior parte di questi problemi.

1. Installazione

Su macOS, Linux e WSL2, un solo comando installa Kin e collega gli strumenti di coding AI che trova. Richiede Node.js 20 o superiore:

npx -y @kinlab/kin setup

Su una macchina senza Node, esegui invece l'installer. get.kinlab.ai e get.kinlab.dev servono lo stesso script:

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

In entrambi i casi, ricarica la shell come comando separato, perché l'installazione mette kin in ~/.kin/bin e aggiunge quella directory al profilo della shell per le nuove sessioni:

exec "$SHELL" -l

Su Windows x64 nativo, installa da PowerShell con irm https://get.kinlab.dev/install.ps1 | iex. Installa la CLI kin e non collega gli strumenti di coding AI, perché WSL2 rimane il percorso consigliato su Windows. La voce Windows sotto Limiti della beta indica cosa funziona lì. Non viene pubblicata alcuna build nativa per Windows ARM64. Su una macchina ARM64, esegui quella riga da PowerShell x64 per installare la build x86_64 in emulazione, oppure usa WSL2. L'installer aggiunge kin al PATH utente, quindi apri una nuova finestra di PowerShell al posto di exec "$SHELL" -l prima del passaggio successivo.

Per altri installer o per la risoluzione dei problemi, consulta la guida rapida completa.

2. Inizializza il repository

Al nuovo prompt, clona un repository con Kin:

kin clone https://github.com/pallets/itsdangerous

Oppure inizializzane uno che hai già, sostituendo il percorso seguente:

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

Entrambi terminano con il prossimo comando da eseguire, una domanda kin refs riguardante una funzione in quel repository. Collegano inoltre ad esso Codex CLI e Grok CLI quando lo hai consentito durante la configurazione, perché quei client mantengono una singola voce che nomina un repository.

Windows PowerShell 5.1 non dispone di &&, quindi su Windows nativo esegui gli stessi comandi uno alla volta e interrompi se uno fallisce:

cd C:\path\to\your\repository
kin init .
kin overview
kin status

kin overview mostra le entità importate da Kin. kin status mostra cosa è stato ammesso e lo stato dell'albero di lavoro rispetto ad esso. kin graph status riporta il grafo delle query live del daemon e la copertura. Le modifiche non committate e non tracciate non fanno parte della cronologia Git importata; kin init riporta ciò che ha escluso.

3. Fai una domanda verificabile

Cerca qualcosa che sai già essere nel codice:

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

Sostituisci ExactEntityName qui sotto con un simbolo dal risultato:

kin refs ExactEntityName
kin trace ExactEntityName
kin impact ExactEntityName

refs restituisce i riferimenti registrati, trace recupera il contesto circostante e impact esplora i potenziali effetti attraverso il grafo. Verifica i risultati rispetto alla fonte.