kin v0.4.5
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 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.
Alpha público. Comece com um repositório pequeno que você conhece bem. Espere arestas ásperas e mudanças que quebram compatibilidade.
Quickstart · Documentação · Demo no navegador
Uma estrela ajuda outras pessoas a encontrar o Kin, e Discussions é onde trazer uma pergunta 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 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 Claude Code:
/plugin marketplace add firelock-ai/kin
/plugin install kin@kin
Para 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 Cursor, adicione o servidor MCP manualmente; veja plugins/kin-cursor para o trecho exato.
Após instalar, execute kin init . em um repositório pequeno 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.
Quickstart
Use uma cópia descartável de um repositório Git pequeno. A importação inclui todo o histórico alcançável e pode levar bastante tempo e memória. Clones rasos, submódulos e Git LFS não são suportados.
1. Instalar
Um comando, e é o mesmo no macOS, Linux, Windows e WSL. Ele instala o Kin, conecta as ferramentas de codificação com IA que encontrar, e requer 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
Para Windows PowerShell, outros instaladores ou solução de problemas, veja o quickstart completo.
2. Inicializar o repositório
No novo prompt, substitua o caminho abaixo:
cd /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. Mudanças 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. Verifique os resultados contra o código-fonte.
4. Conecte seu agente
Prepare embeddings locais, depois configure os clientes MCP detectados:
kin embed &&
kin setup --intent agent &&
kin setup status --json
O Kin suporta Claude Code, Codex, Cursor, Gemini e outros clientes MCP. Use kin setup --intent editor para VS Code. O Kin também inclui kin agent run para endpoints de modelos compatíveis com OpenAI locais ou hospedados.
Configuração de cliente · Ferramentas MCP · Agente integrado
Importações locais, armazenamento e consultas rodam na sua máquina. A instalação e o download inicial do modelo de embedding precisam de acesso à rede. Antes que os embeddings estejam prontos, kin locate usa sinais lexicais e de grafo e reporta a cobertura vetorial ausente.
Revise uma mudança
Após executar kin init no branch Git que você quer revisar, compare SHAs de commit explícitos contra main:
kin review shadow "$(git rev-parse main)..$(git rev-parse HEAD)"
O relatório retorna PASS, NEEDS ATTENTION ou WOULD BLOCK, com impacto derivado do grafo e evidências de suporte. É consultivo: não bloqueia um merge nem altera o estado do grafo. A autoria é declarada, não verificada de forma independente.
Use o Kin com ou sem Git
O Kin tem seus próprios commits, branches, merges, diffs e histórico, inclusive em repositórios sem Git por baixo. Repositórios Git existentes podem ser importados, e fluxos de trabalho suportados podem exportar um novo repositório Git.
Passo a passo de controle de versão nativo · Interoperabilidade com Git e limites de exportação
Limites do alpha
A cobertura é incompleta. Linguagens suportadas são analisadas em entidades e relacionamentos; outros arquivos permanecem disponíveis como conteúdo e histórico. Um resultado vazio não prova que não há chamadores ou dependências. Continue usando seu compilador, testes e revisão. Veja suporte a linguagens.