Kin
Recuperación semántica de código sobre un grafo de entidades, relaciones, cambios y procedencia. Localización, búsqueda, paquetes de contexto, trazado de flujo de datos y análisis de impacto sin búsqueda en archivos sin procesar.
Documentación
Un nuevo fundamento para el código.
Kin es un repositorio de código nativo de grafos para personas y agentes de IA. Almacena el código fuente, las relaciones de código registradas y el historial versionado como estado del repositorio. El grafo es el modelo del repositorio, no un índice de búsqueda mantenido junto a otro repositorio.
Las funciones, los tipos y las relaciones entre ellos son datos que confirmas, ramificas y fusionas. El código fuente exacto se conserva byte por byte, y las proyecciones del sistema de archivos permiten que las herramientas compatibles sigan funcionando con archivos ordinarios.
Beta pública. Prueba Kin en un proyecto real que conozcas bien. Espera bordes sin pulir.
Inicio rápido · Documentación · Demo en navegador
Una estrella ayuda a que otras personas encuentren Kin, y Discussions es el lugar para plantear una pregunta al respecto.
Mira lo que se conecta
Antes de cambiar una función compartida, ¿qué más deberías inspeccionar? Kin te permite buscar 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 puedan trabajar desde el mismo registro.
Registrado en un grafo de ripgrep preparado en e89fff89ac9af12e8d4ce9d5fd07beb408ca730f. Los artefactos de ejecución en bruto no son públicos. Esto ilustra un flujo de trabajo, no un punto de referencia 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 manualmente; consulta plugins/kin-cursor para el fragmento exacto.
Después de instalar, ejecuta kin init . en un clon nuevo de un proyecto que conozcas bien; la habilidad kin-setup te guía por el resto.
Kin no está publicado en crates.io. El crate kin allí es un proyecto no relacionado.
Inicio rápido
Comienza en un clon nuevo y completo de un proyecto que conozcas bien. kin init lee tu historial de Git sin cambiarlo ni modificar tus archivos rastreados. Añade un directorio .kin y una línea a .git/info/exclude. La importación cubre cada confirmación a la que llegan tus ramas y etiquetas, por lo que el tiempo, la memoria y el disco crecen con el historial en lugar de con el tamaño del checkout. Antes de comenzar, kin init verifica la memoria y el disco libre y se detiene con los números cuando ya puede decir que la máquina es insuficiente. Los clones superficiales, los submódulos y Git LFS no son compatibles, y los hooks de Git, un checkout disperso o una fusión o rebase sin terminar también detienen la importación. kin init nombra la solución para cada caso, y un clon nuevo evita la mayoría de ellos.
1. Instalar
En macOS, Linux y WSL2, un comando instala Kin y conecta las herramientas de codificación de IA que encuentra. Necesita Node.js 20 o más reciente:
npx -y @kinlab/kin setup
En una máquina sin Node, ejecuta el instalador en su lugar. get.kinlab.ai y get.kinlab.dev sirven el mismo script:
curl -fsSL https://get.kinlab.dev/install | sh
De cualquier manera, recarga tu shell como un comando separado, porque la instalación coloca kin en ~/.kin/bin y añade ese directorio a tu perfil de shell para nuevas sesiones:
exec "$SHELL" -l
En Windows nativo x64, instala desde PowerShell con irm https://get.kinlab.dev/install.ps1 | iex. Instala la CLI kin y no conecta herramientas de codificación de IA, porque WSL2 sigue siendo la ruta recomendada en Windows. La entrada de Windows bajo Límites de beta dice qué funciona allí. No se publica una compilación nativa de Windows ARM64. En una máquina ARM64, ejecuta esa línea desde PowerShell x64 para instalar la compilación x86_64 bajo emulación, o usa WSL2. El instalador añade kin a tu PATH de usuario, así que abre una nueva ventana de PowerShell en lugar de exec "$SHELL" -l antes del siguiente paso.
Para otros instaladores o solución de problemas, consulta el inicio rápido completo.
2. Inicializar el repositorio
En el nuevo prompt, clona un repositorio con Kin:
kin clone https://github.com/pallets/itsdangerous
O inicializa uno que ya tengas, reemplazando la ruta a continuación:
cd /path/to/your/repository &&
kin init . &&
kin overview &&
kin status
Ambos terminan con el siguiente comando a ejecutar, una pregunta kin refs sobre una función en ese repositorio. También conectan Codex CLI y Grok CLI a él cuando lo permitiste durante la configuración, porque esos clientes mantienen una entrada que nombra un repositorio.
Windows PowerShell 5.1 no tiene &&, así que en Windows nativo ejecuta los mismos comandos uno a la vez y detente si uno falla:
cd C:\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 en relación con ello. kin graph status informa el grafo de consultas en vivo del daemon y la cobertura. Los cambios no confirmados y no rastreados no forman parte del historial de Git importado; kin init informa lo que omitió.
3. Haz una pregunta que puedas verificar
Busca algo que ya sepas que está en el código:
kin locate "<something you already know is in this repository>"
Reemplaza ExactEntityName a continuación con un símbolo del resultado:
kin refs ExactEntityName
kin trace ExactEntityName
kin impact ExactEntityName
refs devuelve referencias registradas, trace trae contexto cercano, y impact explora efectos potenciales a través del grafo. Verifica los resultados contra el código fuente.
4. Tus herramientas de codificación de IA y búsqueda semántica
kin setup ya preguntó antes de conectar las herramientas de codificación de IA que encontró, y las conectó si dijiste que sí. No hay un paso de vinculación separado. Después de instalar otra herramienta, ejecuta kin setup de nuevo, y kin setup status muestra lo que está conectado. En Windows, conecta las herramientas de IA dentro de WSL2.
La búsqueda semántica se ejecuta en un modelo local de aproximadamente 523 MB, y la configuración pregunta antes de que se descargue algo. Si dijiste que no, o kin init dice que el índice de búsqueda está esperando el modelo, esto lo descarga y construye el índice:
kin embed
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 de clientes · 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 incrustación necesitan acceso a la red. Antes de que las incrustaciones estén listas, kin locate usa señales léxicas y de grafo e informa la cobertura de vectores faltante.
Revisar un cambio
Después de ejecutar kin init en la rama de Git que quieres revisar, compara SHAs de confirmación 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 impacto derivado del grafo y evidencia de respaldo. Es de carácter consultivo: 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 propias confirmaciones, ramas, fusiones, diferencias e historial, incluso en repositorios sin Git subyacente. Los repositorios de Git existentes se pueden importar, y los flujos de trabajo compatibles pueden exportar un nuevo repositorio de Git.
Tutorial de control de versiones nativo · Interoperabilidad con Git y límites de exportación
Límites de beta
La cobertura es incompleta. Los lenguajes compatibles se analizan en entidades y relaciones; otros archivos permanecen disponibles como contenido e historial. Un resultado vacío no prueba que no haya llamadores o dependencias. Sigue usando tu compilador, pruebas y revisión. Consulta soporte de lenguajes.
La compatibilidad varía. Los archivos de lanzamiento no incluyen la proyección de sistema de archivos obsoleta kin-vfs, por lo que no hay una proyección transparente en la que confiar. Consulta notas de plataforma para ver qué admite cada plataforma.
Haz copias de seguridad del estado exclusivo de Kin. Las confirmaciones, ramas, revisiones y especificaciones que registras con Kin viven en .kin, no en Git. Eliminar .kin y reimportar desde Git no las recupera, así que ejecuta kin backup create primero. Lee las notas de importación, recuperación y actualización.
Windows. El soporte nativo de Windows x86_64 es temprano. La admisión de repositorios funciona: kin init importa un repositorio de Git y publica autoridad de grafo, y las consultas de grafo, léxicas y respaldadas por daemon responden de forma nativa. La prueba de instalación de extremo a extremo también ejecuta la configuración del agente en Windows nativo y obtiene respuestas respaldadas por grafo del servidor MCP instalado. La proyección transparente del sistema de archivos no se envía en Windows, y los flujos de trabajo de revisión aún no se prueban allí, por lo que WSL2 sigue siendo la ruta recomendada para la experiencia completa de Kin.
Por qué construí Kin
Seguía viendo a los agentes de codificación ensamblar partes de un código base que ya habíamos trabajado. Luego hacía una versión de ese trabajo yo mismo para revisar sus cambios. Empecé a preguntarme por qué más de esa comprensión estructural no era parte del repositorio en sí.
Eso es lo que estoy construyendo con Kin.
Troy
Aprende más y contribuye
Referencia de CLI · Arquitectura y límites detallados · Contribuir · Problemas · Seguridad
Kin y su pila local, incluido kin-db, son Apache-2.0. KinLab es el producto alojado propietario separado. La incorporación de repositorios públicos aún está en desarrollo.