kin v0.3.4
El sistema semántico de registro para software escrito por IA: un grafo de entidades y relaciones, no diferencias de archivos.
Una nueva base 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 a 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 asperezas.
Inicio rápido · Documentación · Demo en el navegador
Una estrella ayuda a que otras personas encuentren Kin, y Discussions es el lugar donde plantear una pregunta al respecto.
Ve lo que 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, así 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 el fragmento exacto.
Tras instalar, ejecuta kin init . en un clon nuevo de un proyecto que conozcas bien; la skill 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
Empieza en un clon nuevo y completo de un proyecto que conozcas bien. kin init lee tu historial de Git sin modificarlo ni alterar tus archivos rastreados. Añade un directorio .kin y una línea a .git/info/exclude. La importación abarca cada commit al que llegan tus ramas y etiquetas, así que el tiempo, la memoria y el disco crecen con el historial y no con el tamaño del checkout. Antes de empezar, kin init comprueba la memoria y el disco libre y se detiene mostrando las cifras cuando ya puede determinar que a la máquina le falta. No se admiten clones superficiales, submódulos ni Git LFS, y los hooks de Git, un checkout disperso o una fusión o rebase sin terminar también detienen la importación. kin init indica la solución para cada caso, y un clon nuevo evita la mayoría de ellos.
1. Instalar
En macOS, Linux y WSL2, un solo comando instala Kin y conecta las herramientas de codificación con IA que encuentra. Necesita Node.js 20 o superior:
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
En cualquiera de los dos casos, recarga tu shell como un comando aparte, porque la instalación coloca kin en
~/.kin/bin y añade ese directorio a tu perfil de shell para las nuevas sesiones:
exec "$SHELL" -l
En Windows x64 nativo, instala desde PowerShell con irm https://get.kinlab.dev/install.ps1 | iex.
Instala la CLI kin y no conecta herramientas de codificación con IA, porque WSL2 sigue siendo la
ruta recomendada en Windows. La entrada de Windows en Límites de la beta
indica qué funciona allí. No se publica ninguna compilación nativa para 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 de abajo:
cd /path/to/your/repository &&
kin init . &&
kin overview &&
kin status
Ambos terminan con el siguiente comando a ejecutar, una pregunta de kin refs sobre una función en ese
repositorio. También conectan Codex CLI y Grok CLI a él cuando lo permitiste en 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 alguno 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 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 verificar
Busca algo que ya sabes que está en el código:
kin locate "<something you already know is in this repository>"
Reemplaza 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 contexto cercano, e impact explora los efectos potenciales a través del grafo. Contrasta los resultados con el código fuente.
4. Tus herramientas de codificación con IA y la búsqueda semántica
kin setup ya preguntó antes de conectar las herramientas de codificación con IA que encontró, y las conectó
si dijiste que sí. No hay un paso de vinculación aparte. Después de instalar otra herramienta, ejecuta
kin setup de nuevo, y kin setup status muestra qué está conectado. En Windows, conecta las herramientas de IA
dentro de WSL2.