kin v0.7.20

Uma nova base para código.

Kin é um repositório de código nativo em grafo para pessoas e agentes de IA. Ele armazena código-fonte, relacionamentos de código registrados e 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 os relacionamentos entre eles são dados que você faz commit, branch e merge. O código-fonte exato é preservado byte a byte, e 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 encontrarem 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, então você e seu agente podem trabalhar a partir do mesmo registro.

Registrado em um grafo preparado do ripgrep 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 no Claude Code, Codex ou Cursor

Para o Claude Code:

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

Para o Codex, adicione o marketplace e instale o plugin, ou deixe kin setup --intent agent escrever o servidor MCP em ~/.codex/config.toml para você.

Para o Cursor, adicione o servidor MCP manualmente; veja plugins/kin-cursor para o trecho exato.

Após instalar, execute kin init . em um clone novo de um projeto que você conhece bem; a skill kin-setup orienta você pelo resto.

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. kin init lê seu histórico Git sem alterá-lo nem aos seus arquivos rastreados. Ele adiciona um diretório .kin e uma linha em .git/info/exclude. A importação cobre todos os commits alcançados pelos seus branches e tags, então tempo, memória e disco crescem com o histórico, não com o tamanho do checkout. Antes de começar, kin init verifica memória e disco livre e para com os números quando já consegue perceber que a máquina está no limite. Clones rasos, 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. kin init indica a correção para cada caso, e um clone novo evita a maioria deles.

1. Instalar

No macOS, Linux e WSL2, um comando instala o Kin e conecta as ferramentas de codificação com IA que encontra. Ele precisa do Node.js 20 ou mais recente:

npx -y @kinlab/kin setup

Em uma máquina sem Node, execute o instalador. get.kinlab.ai e get.kinlab.dev servem o mesmo script:

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

De qualquer forma, recarregue seu shell como um comando separado, porque a instalação coloca kin em ~/.kin/bin e adiciona esse diretório ao seu perfil de shell para novas sessões:

exec "$SHELL" -l

No Windows x64 nativo, instale pelo PowerShell com irm https://get.kinlab.dev/install.ps1 | iex. Ele instala a CLI kin e não conecta ferramentas de codificação com IA, porque o WSL2 continua sendo o caminho recomendado no Windows. A entrada do Windows em Limites do beta diz o que funciona lá. Nenhuma build nativa para Windows ARM64 é publicada. Em uma máquina ARM64, execute essa linha no 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, veja o início rápido completo.

2. Inicializar 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á tem, 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 naquele repositório. Eles também conectam 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 reporta o grafo de consulta ao vivo 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 reporta o que deixou 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. Confira os resultados com o código-fonte.

4. Suas ferramentas de codificação com IA e busca semântica

kin setup já perguntou antes de conectar as ferramentas de codificação com IA que encontrou, e as conectou se você disse sim. Não há uma etapa separada de vinculação. Depois de instalar outra ferramenta, execute kin setup novamente, e kin setup status mostra o que está conectado. No Windows, conecte as ferramentas de IA dentro do WSL2.

A busca semântica roda em um modelo local de cerca de 523 MB, e a configuração pergunta antes que qualquer coisa o baixe. Se você disse não, ou kin init diz que o índice de busca está aguardando o modelo, isto o baixa e constrói o índice: