kin v0.3.4
O sistema semântico de registro para software escrito por IA: um gráfico de entidades e relações, não diffs de arquivos.
Uma nova base para o código.
Kin é um repositório de código nativo em grafo para agentes de IA e as pessoas que constroem com eles. Ele armazena o código-fonte, as relações de código registradas e o histórico versionado como estado do repositório. O grafo é o modelo do repositório, não um índice de busca mantido ao lado de outro repositório.
Funções, tipos e as relações entre eles são dados que você faz commit, branch e merge. O código-fonte exato é preservado byte a byte, e as projeções de sistema de arquivos permitem que ferramentas compatíveis continuem funcionando com arquivos comuns.
Beta público. Experimente o Kin em um projeto real que você conhece bem. Espere arestas ásperas.
Início rápido · Documentação · Demonstração no navegador
Uma estrela ajuda outras pessoas a encontrar o Kin, e as Discussões são o lugar para trazer uma dúvida sobre ele.
Veja o que se conecta
Antes de alterar uma função compartilhada, o que mais você deveria inspecionar? O Kin permite consultar seus chamadores registrados e explorar código relacionado. A CLI e o servidor MCP consultam o mesmo grafo, para que você e seu agente possam trabalhar a partir do mesmo registro.
Registrado em um grafo do ripgrep preparado em e89fff89ac9af12e8d4ce9d5fd07beb408ca730f. Os artefatos brutos da execução não são públicos. Isto ilustra um fluxo de trabalho, não um benchmark de desempenho.
Use a partir do Claude Code, Codex ou Cursor
Para o Claude Code:
/plugin marketplace add kinlab-ai/kin
/plugin install kin@kin
Para o Codex, adicione o marketplace e instale o plugin, ou deixe que kin setup --intent agent grave o servidor MCP em ~/.codex/config.toml por você.
Para o Cursor, adicione o servidor MCP manualmente; consulte plugins/kin-cursor para o trecho exato.
Após a instalação, execute kin init . em um clone novo de um projeto que você conhece bem; a skill kin-setup orienta você no restante.
O Kin não é publicado no crates.io. O crate kin lá é um projeto não relacionado.
Início rápido
Comece em um clone novo e completo de um projeto que você conhece bem. O kin init lê seu histórico Git sem alterá-lo nem aos seus arquivos rastreados. Ele mantém seu armazenamento fora do seu checkout, em ~/.kin/stores, e não grava nada no repositório; kin store path imprime onde fica o armazenamento de um checkout. Por padrão, ele admite primeiro o commit em checkout, de modo que as perguntas são respondidas assim que essa árvore é lida, e depois importa em segundo plano, com baixa prioridade, todos os commits alcançados pelos seus branches e tags; kin init --history full importa todo o histórico de antemão, e --history none nunca o importa. A importação do histórico consome tempo, memória e disco que crescem com o histórico, e não com o tamanho do checkout. Antes de começar, o kin init verifica a memória e o disco livre e para com os números quando já consegue identificar que a máquina está com recursos insuficientes. Um clone raso admite apenas seu commit em checkout, e submódulos e Git LFS não são suportados, e hooks do Git, um checkout esparso ou um merge ou rebase inacabado também interrompem a importação. O kin init indica a correção para cada caso, e um clone novo evita a maioria deles.
1. Instalação
No macOS, Linux e WSL2, um único comando instala o Kin e conecta as ferramentas de codificação com IA que ele encontra. Ele requer Node.js 20 ou mais recente:
npx -y @kinlab/kin setup
Em uma máquina sem Node, execute o instalador em vez disso. get.kinlab.ai e get.kinlab.dev servem o mesmo script:
curl -fsSL https://get.kinlab.dev/install | sh
De qualquer forma, recarregue o seu shell como um comando separado, porque a instalação coloca o kin em
~/.kin/bin e adiciona esse diretório ao perfil do seu shell para novas sessões:
exec "$SHELL" -l
No Windows x64 nativo, instale a partir do PowerShell com irm https://get.kinlab.dev/install.ps1 | iex.
Ele instala a CLI kin e não conecta ferramentas de codificação de IA, porque o WSL2 continua sendo o
caminho recomendado no Windows. A entrada do Windows em Limites da versão Beta
descreve o que funciona lá. Nenhuma build nativa para Windows ARM64 é publicada. Em uma máquina ARM64, execute
essa linha a partir do PowerShell x64 para instalar a build x86_64 sob emulação, ou use o WSL2.
O instalador adiciona kin ao PATH do seu usuário, então abra uma nova janela do PowerShell no lugar de
exec "$SHELL" -l antes do próximo passo.
Para outros instaladores ou solução de problemas, consulte o quickstart completo.
2. Inicialize o repositório
No novo prompt, clone um repositório com o Kin:
kin clone https://github.com/pallets/itsdangerous
Ou inicialize um que você já tenha, substituindo o caminho abaixo:
cd /path/to/your/repository &&
kin init . &&
kin overview &&
kin status
Ambos terminam com o próximo comando a executar, uma pergunta kin refs sobre uma função nesse repositório. Também ligam o Codex CLI e o Grok CLI a ele quando você permitiu isso na configuração, porque esses clientes mantêm uma entrada que nomeia um repositório.
O Windows PowerShell 5.1 não tem &&, então no Windows nativo execute os mesmos comandos um de cada vez e pare se algum falhar:
cd C:\path\to\your\repository
kin init .
kin overview
kin status
kin overview mostra as entidades que o Kin importou. kin status mostra o que foi admitido e o estado da árvore de trabalho em relação a isso. kin graph status relata o grafo de consultas ativo do daemon e a cobertura. Alterações não commitadas e não rastreadas não fazem parte do histórico Git importado; kin init relata o que foi deixado de fora.
3. Faça uma pergunta que você possa verificar
Procure algo que você já sabe que está no código:
kin locate "<something you already know is in this repository>"
Substitua ExactEntityName abaixo por um símbolo do resultado:
kin refs ExactEntityName
kin trace ExactEntityName
kin impact ExactEntityName
refs retorna referências registradas, trace traz contexto próximo e impact explora efeitos potenciais através do grafo. Verifique os resultados em relação à fonte.