kin v0.4.8
El sistema de registro semántico para software escrito por IA: un grafo de entidades y relaciones, no diffs de archivos.
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.