kin v0.6.4
Control de versiones basado en grafos semánticos para código escrito por IA. Rastrea entidades y relaciones en lugar de diferencias de archivos, lo que permite el análisis de radio de impacto, la revisión de fusiones en sombra y el contexto de agentes impulsado por MCP para software generado por IA confiable.
La IA cambió quién escribe código.
Kin cambia sobre qué se construye.
Kin es un repositorio de código y sistema de control de versiones de código abierto para personas y agentes de IA. Lleva un registro de cómo encaja el código, para que puedas investigar qué podría afectar un cambio.
Las funciones, los tipos, las relaciones registradas y el historial de cambios son datos del repositorio que confirmas, ramificas y fusionas. El grafo es el modelo del repositorio, no un índice separado junto a Git. El código fuente exacto se conserva byte a byte, y las proyecciones del sistema de archivos permiten que las herramientas compatibles sigan funcionando con archivos normales.
Una estrella ayuda a que otras personas encuentren Kin, y Discussions es el lugar donde plantear una pregunta al respecto.
Alpha pública. Empieza con un repositorio pequeño que conozcas bien. Espera asperezas y cambios que rompan la compatibilidad.
Inicio rápido · Documentación · Demo en el navegador
Ve qué se conecta
Antes de cambiar una función compartida, ¿qué más deberías inspeccionar? Kin te permite consultar sus llamadores registrados y explorar el código relacionado. La CLI y el servidor MCP consultan el mismo grafo, para que tú y tu agente podáis trabajar a partir del mismo registro.
Registrado sobre un grafo de ripgrep preparado en e89fff89ac9af12e8d4ce9d5fd07beb408ca730f. Los artefactos de ejecución sin procesar no son públicos. Esto ilustra un flujo de trabajo, no una prueba de rendimiento.
Úsalo desde Claude Code, Codex o Cursor
Para Claude Code:
/plugin marketplace add firelock-ai/kin
/plugin install kin@kin
Para Codex, añade el marketplace e instala el plugin, o deja que kin setup --intent agent escriba el servidor MCP en ~/.codex/config.toml por ti.
Para Cursor, añade el servidor MCP a mano; consulta plugins/kin-cursor para ver el fragmento exacto.
Después de instalar, ejecuta kin init . en un repositorio pequeño que conozcas bien; la habilidad kin-setup te guía por el resto.
Kin no está publicado en crates.io. El crate kin que hay allí es un proyecto no relacionado.
Inicio rápido
Usa una copia desechable de un repositorio Git pequeño. La importación incluye todo su historial alcanzable y puede tardar bastante tiempo y memoria. No se admiten clones superficiales, submódulos ni Git LFS.
1. Instalar
En macOS o Linux, ejecuta el instalador y completa sus indicaciones de configuración:
curl -fsSL https://get.kinlab.dev/install | sh
Cuando termine, recarga tu shell como un comando aparte:
exec "$SHELL" -l
Para Windows, instaladores alternativos o solución de problemas, consulta el inicio rápido completo.
2. Inicializar el repositorio
En el nuevo prompt, sustituye la ruta de abajo:
cd /path/to/your/repository &&
kin init . &&
kin overview &&
kin status
kin overview muestra las entidades que Kin importó. kin status muestra lo que se admitió y el estado del árbol de trabajo respecto a ello. kin graph status informa del grafo de consultas en vivo del daemon y su cobertura. Los cambios sin confirmar y no rastreados no forman parte del historial de Git importado; kin init informa de lo que dejó fuera.
3. Haz una pregunta que puedas comprobar
Busca algo que ya sepas que está en el código:
kin locate "<something you already know is in this repository>"
Sustituye ExactEntityName de abajo por un símbolo del resultado:
kin refs ExactEntityName
kin trace ExactEntityName
kin impact ExactEntityName
refs devuelve las referencias registradas, trace incorpora el contexto cercano, e impact explora los efectos potenciales a través del grafo. Comprueba los resultados contra el código fuente.
4. Conecta tu agente
Prepara los embeddings locales y luego configura los clientes MCP detectados:
kin embed &&
kin setup --intent agent &&
kin setup status --json
Kin es compatible con Claude Code, Codex, Cursor, Gemini y otros clientes MCP. Usa kin setup --intent editor para VS Code. Kin también incluye kin agent run para endpoints de modelos compatibles con OpenAI, locales o alojados.
Configuración del cliente · Herramientas MCP · Agente integrado
Las importaciones, el almacenamiento y las consultas locales se ejecutan en tu máquina. La instalación y la descarga inicial del modelo de embeddings necesitan acceso a la red. Antes de que los embeddings estén listos, kin locate usa señales léxicas y del grafo e informa de la cobertura vectorial que falta.
Revisa un cambio
Después de ejecutar kin init en la rama de Git que quieras revisar, compara SHAs de commit explícitos contra main:
kin review shadow "$(git rev-parse main)..$(git rev-parse HEAD)"
El informe devuelve PASS, NEEDS ATTENTION o WOULD BLOCK, con el impacto derivado del grafo y las pruebas que lo respaldan. Es orientativo: no bloquea una fusión ni cambia el estado del grafo. La autoría se declara, no se verifica de forma independiente.
Usa Kin con o sin Git
Kin tiene sus propios commits, ramas, fusiones, diffs e historial, incluso en repositorios sin Git por debajo. Los repositorios Git existentes se pueden importar, y los flujos de trabajo compatibles pueden exportar un nuevo repositorio Git.
Recorrido por el control de versiones nativo · Interoperabilidad con Git y límites de exportación
Límites de la alpha
La cobertura es incompleta. Los lenguajes compatibles se analizan en entidades y relaciones; los demás archivos siguen disponibles como contenido e historial. Un resultado vacío no demuestra que no haya llamadores o dependencias. Sigue usando tu compilador, tus pruebas y tu revisión. Consulta compatibilidad de lenguajes.
La compatibilidad varía. La proyección del sistema de archivos tiene restricciones separadas de plataforma y de herramientas. Consulta las notas de plataforma antes de depender de ella.
Conserva el estado exclusivo de Kin. Eliminar .kin y reimportar desde Git no recupera commits, revisiones ni otro estado que existiera solo en Kin. Lee las notas de importación, recuperación y actualización.
Windows. La compatibilidad nativa con Windows x86_64 es temprana. La admisión de repositorios funciona: kin init importa un repositorio Git y publica la autoridad del grafo, y las consultas respaldadas por el grafo, léxicas y del daemon responden de forma nativa. La proyección transparente del sistema de archivos no se distribuye en Windows, y la prueba de instalación de extremo a extremo aún no cubre los flujos de trabajo de MCP ni de revisión allí, así que WSL2 sigue siendo la ruta recomendada para la experiencia completa de Kin.
Por qué construí Kin
No dejaba de ver a agentes de programación recomponer partes de un código que ya habíamos trabajado. Luego yo hacía una versión de ese trabajo para revisar sus cambios. Empecé a preguntarme por qué más de esa comprensión estructural no formaba parte del propio repositorio.
Eso es lo que estoy construyendo con Kin.
Troy
Aprende más y contribuye
Referencia de la CLI · Arquitectura y límites detallados · Contribuir · Issues · Seguridad
Kin y su stack local, incluido kin-db, son Apache-2.0. KinLab es el producto alojado propietario independiente. La incorporación de repositorios públicos aún está en desarrollo.