kin v0.6.4

L'AI ha cambiato chi scrive il codice.
Kin cambia ciò su cui si costruisce.

Kin è un repository di codice e sistema di controllo di versione open-source per persone e agenti AI. Tiene traccia di come il codice è strutturato, così puoi indagare su cosa potrebbe influenzare una modifica.

Funzioni, tipi, relazioni registrate e cronologia delle modifiche sono dati del repository che puoi committare, ramificare e unire. Il grafo è il modello del repository, non un indice separato accanto a Git. Il codice sorgente esatto è preservato byte per byte, e le proiezioni del filesystem permettono agli strumenti supportati di continuare a lavorare con file ordinari.

Una stella aiuta altre persone a trovare Kin, e le Discussioni sono il luogo dove portare una domanda al riguardo.

Alpha pubblica. Inizia con un piccolo repository che conosci bene. Aspettati imperfezioni e modifiche che rompono la compatibilità.

Avvio rapido · Documentazione · Demo nel browser

Vedi cosa si connette

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 firelock-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; vedi plugins/kin-cursor per lo snippet esatto.

Dopo l'installazione, esegui kin init . in un piccolo repository 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

Usa una copia usa e getta di un piccolo repository Git. L'importazione include tutta la sua cronologia raggiungibile e può richiedere tempo e memoria considerevoli. I cloni shallow, i sottomoduli e Git LFS non sono supportati.

1. Installa

Su macOS o Linux, esegui l'installer e completa i suoi prompt di configurazione:

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

Dopo che ha finito, ricarica la tua shell come comando separato:

exec "$SHELL" -l

Per Windows, installer alternativi o risoluzione dei problemi, vedi l'avvio rapido completo.

2. Inizializza il repository

Al nuovo prompt, sostituisci il percorso sottostante:

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

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

3. Fai una domanda che puoi verificare

Cerca qualcosa che sai già essere nel codice:

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

Sostituisci ExactEntityName sotto con un simbolo dal risultato:

kin refs ExactEntityName
kin trace ExactEntityName
kin impact ExactEntityName

refs restituisce i riferimenti registrati, trace porta il contesto vicino, e impact esplora i potenziali effetti attraverso il grafo. Verifica i risultati rispetto al codice sorgente.

4. Connetti il tuo agente

Prepara gli embedding locali, poi configura i client MCP rilevati:

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

Kin supporta Claude Code, Codex, Cursor, Gemini e altri client MCP. Usa kin setup --intent editor per VS Code. Kin include anche kin agent run per endpoint di modelli compatibili con OpenAI, locali o ospitati.

Configurazione del client · Strumenti MCP · Agente integrato

Le importazioni, l'archiviazione e le query locali vengono eseguite sulla tua macchina. L'installazione e il download iniziale del modello di embedding richiedono accesso alla rete. Prima che gli embedding siano pronti, kin locate usa segnali lessicali e del grafo e riporta la copertura vettoriale mancante.

Rivedi una modifica

Dopo aver eseguito kin init sul branch Git che vuoi rivedere, confronta gli SHA dei commit espliciti rispetto a main:

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

Il report restituisce PASS, NEEDS ATTENTION o WOULD BLOCK, con l'impatto derivato dal grafo e le prove di supporto. È consultivo: non blocca un merge né modifica lo stato del grafo. La paternità è dichiarata, non verificata in modo indipendente.

Usa Kin con o senza Git

Kin ha i propri commit, branch, merge, diff e cronologia, anche in repository senza Git sotto. I repository Git esistenti possono essere importati, e i flussi di lavoro supportati possono esportare un nuovo repository Git.

Guida al controllo di versione nativo · Interoperabilità con Git e limiti di esportazione

Limiti dell'alpha

La copertura è incompleta. Le lingue supportate vengono analizzate in entità e relazioni; gli altri file rimangono disponibili come contenuto e cronologia. Un risultato vuoto non prova che non ci siano chiamanti o dipendenze. Continua a usare il tuo compilatore, i test e la revisione. Vedi supporto delle lingue.

La compatibilità varia. La proiezione del filesystem ha restrizioni separate per piattaforma e strumenti. Controlla le note sulla piattaforma prima di farci affidamento.

Preserva lo stato solo-Kin. Eliminare .kin e reimportare da Git non recupera commit, revisioni o altro stato che esisteva solo in Kin. Leggi le note su importazione, recupero e aggiornamento.

Windows. Il supporto nativo per Windows x86_64 è agli inizi. L'ammissione del repository funziona: kin init importa un repository Git e pubblica l'autorità del grafo, e le query basate su grafo, lessicali e supportate dal daemon rispondono nativamente. La proiezione trasparente del filesystem non è distribuita su Windows, e la prova di installazione end-to-end non copre ancora i flussi di lavoro MCP o di revisione lì, quindi WSL2 rimane il percorso consigliato per l'esperienza Kin completa.

Perché ho costruito Kin

Continuavo a vedere agenti di coding mettere insieme pezzi di un codebase che avevamo già esaminato. Poi facevo una versione di quel lavoro io stesso per rivedere le loro modifiche. Ho iniziato a chiedermi perché una maggiore parte di quella comprensione strutturale non facesse parte del repository stesso.

Questo è ciò che sto costruendo con Kin.

Troy

Scopri di più e contribuisci

Riferimento CLI · Architettura e limiti dettagliati · Contribuire · Problemi · Sicurezza

Kin e il suo stack locale, incluso kin-db, sono Apache-2.0. KinLab è il prodotto ospitato proprietario separato. L'onboarding del repository pubblico è ancora in sviluppo.