LeanKG

Grafo de conocimiento ligero para el desarrollo asistido por IA

LeanKG es un grafo de conocimiento local que proporciona a las herramientas de codificación por IA un contexto preciso de la base de código. Indexa tu código, construye grafos de dependencias y expone un servidor MCP para que herramientas como Cursor, OpenCode y Claude Code puedan consultar el grafo de conocimiento directamente. Sin servicios en la nube, sin bases de datos externas.

Cómo ayuda LeanKG

graph LR
    subgraph "Without LeanKG"
        A1[AI Tool] -->|Scans entire codebase| B1[10,000+ tokens]
        B1 --> A1
    end

    subgraph "With LeanKG"
        A2[AI Tool] -->|13-42 tokens| C[LeanKG Graph]
        C -->|Targeted subgraph| A2
    end

Sin LeanKG: La IA escanea toda la base de código (~10,000+ tokens). Con LeanKG: La IA consulta el grafo de conocimiento para obtener un contexto específico (13-42 tokens). 98% de ahorro de tokens para el análisis de impacto.

Instalación

Instalación en una línea (Recomendado)

curl -fsSL https://raw.githubusercontent.com/FreePeak/LeanKG/main/scripts/install.sh | bash -s -- <target>

Objetivos compatibles:

Ejemplos:

curl -fsSL https://raw.githubusercontent.com/FreePeak/LeanKG/main/scripts/install.sh | bash -s -- cursor
curl -fsSL https://raw.githubusercontent.com/FreePeak/LeanKG/main/scripts/install.sh | bash -s -- claude

Instalar mediante Cargo o compilar desde el código fuente

cargo install leankg && leankg --version

git clone https://github.com/FreePeak/LeanKG.git && cd LeanKG && cargo build --release

Inicio rápido

leankg init                              # Initialize LeanKG in your project
leankg index ./src                        # Index your codebase
leankg watch ./src                        # Auto-index on file changes
leankg impact src/main.rs --depth 3       # Calculate blast radius
leankg status                             # Check index status
leankg metrics                            # View token savings
leankg web                                # Start Web UI at http://localhost:8080

Consulta docs/cli-reference.md para ver todos los comandos.

Aspectos destacados

• Auto-Init -- El script de instalación configura MCP, reglas, habilidades y hooks automáticamente

• Auto-Trigger -- Los hooks de sesión inyectan el contexto de LeanKG en cada sesión de la herramienta de IA

• Conciso en tokens -- 13-42 tokens por consulta frente a 10,000+ para un escaneo completo de la base de código

• Ahorro de tokens -- Hasta un 98% de reducción de tokens para el análisis de impacto

• Radio de impacto -- Calcula el radio de explosión antes de realizar cambios

• Grafo de dependencias -- Construye grafos de llamadas con aristas IMPORTS, CALLS, TESTED_BY

• Servidor MCP -- Expone el grafo mediante el protocolo MCP para la integración con herramientas de IA

• Multi-lenguaje -- Indexa Go, TypeScript, Python, Rust, Java, Kotlin con tree-sitter

Consulta docs/architecture.md para obtener detalles sobre el diseño del sistema y el modelo de datos.

Herramientas de IA compatibles

Nota: Cursor requiere una instalación por proyecto. Las funciones de IA funcionan por espacio de trabajo, por lo que LeanKG debe instalarse en cada directorio de proyecto donde desees la inyección de contexto de IA.

Consulta docs/agentic-instructions.md para obtener información detallada sobre la configuración y el comportamiento de auto-activación.

Interfaz Web

leankg web --port 9000

Visualiza tu grafo de conocimiento con diseño dirigido por fuerzas, renderizado WebGL y agrupación comunitaria.

Consulta docs/web-ui.md para más funciones.

Métricas de contexto

Realiza un seguimiento del ahorro de tokens para comprender la eficiencia de LeanKG.

leankg metrics --json              # View with JSON output
leankg metrics --since 7d           # Filter by time
leankg metrics --tool search_code   # Filter by tool

Consulta docs/metrics.md para ver el esquema y ejemplos.

Actualización

# Check current version
leankg version

# Update LeanKG binary via install script
curl -fsSL https://raw.githubusercontent.com/FreePeak/LeanKG/main/scripts/install.sh | bash -s -- update

Demo en vivo

Prueba LeanKG sin instalar: https://leankg.onrender.com

Documentación

Requisitos

• Rust 1.70+

• macOS o Linux

Licencia

MIT