Cntx UI

cntx-ui

Análisis semántico de código y gestión de contexto para agentes de IA. Convierte un código base en contexto estructurado y buscable que los agentes pueden navegar de manera eficiente.

Qué hace

• Análisis semántico — analiza tu código a nivel de funciones usando tree-sitter, extrae propósito, complejidad y relaciones
• Búsqueda vectorial local — incrusta fragmentos de código localmente (all-MiniLM-L6-v2 vía Transformers.js) para búsqueda de similitud semántica sin llamadas API externas
• Sistema de paquetes — agrupa archivos en paquetes lógicos (por característica, capa o patrón) para entrega de contexto estructurado
• Servidor MCP — expone más de 28 herramientas a Claude Code, Claude Desktop o cualquier cliente compatible con MCP
• Panel web — interfaz visual en localhost:3333 para gestionar paquetes, explorar análisis semántico y editar reglas de agentes
• Sincronización en tiempo real — observa cambios en archivos y mantiene actualizados análisis, paquetes e incrustaciones

Instalación

npm install -g cntx-ui

Uso

cntx-ui init          # scaffold .cntx directory, generate .mcp.json
cntx-ui watch         # start web server on port 3333
cntx-ui mcp           # start MCP server on stdio
cntx-ui bundle <name> # regenerate a specific bundle
cntx-ui status        # show project health and bundle state
cntx-ui setup-mcp     # configure Claude Desktop integration

Después de cntx-ui init, los agentes descubren herramientas automáticamente vía .mcp.json. El archivo .cntx/AGENT.md proporciona un protocolo de incorporación con referencia de herramientas y descripción general del proyecto.

Interfaz de agente

Los agentes interactúan a través de herramientas MCP o la API HTTP:

Herramienta MCP	Qué hace
agent/discover	Descripción general arquitectónica del código base
agent/query	Búsqueda semántica — "¿dónde se maneja la autenticación?"
agent/investigate	Encuentra puntos de integración para una nueva característica
agent/organize	Audita y optimiza la estructura de paquetes
artifacts/list	Lista artefactos de proyecto normalizados (OpenAPI + Navigation)
artifacts/get_openapi	Devuelve resumen y carga útil del artefacto OpenAPI
artifacts/get_navigation	Devuelve resumen y carga útil del artefacto Navigation
artifacts/summarize	Resumen compacto entre artefactos para agentes
list_bundles	Lista todos los paquetes con metadatos
get_bundle	Obtiene contenido completo del paquete como XML
get_semantic_chunks	Obtiene todos los fragmentos de código analizados
read_file / write_file	Operaciones de archivos con contexto de paquete

La referencia completa de herramientas con parámetros se genera en .cntx/AGENT.md y .cntx/TOOLS.md.

Puntos finales HTTP de artefactos:

• GET /api/artifacts
• GET /api/artifacts/openapi
• GET /api/artifacts/navigation

Cómo funciona

1. tree-sitter analiza archivos fuente en AST, extrae funciones/tipos/interfaces
2. Motor de heurísticas clasifica cada fragmento por propósito, dominio de negocio y patrones técnicos basados en rutas de archivos, importaciones y convenciones de nombres
3. Incrustaciones se generan localmente y se almacenan en SQLite para búsqueda vectorial persistente
4. Paquetes agrupan archivos por patrones glob — sugeridos automáticamente al iniciar según la estructura del proyecto
5. Servidor MCP y API HTTP exponen todo a los agentes con formas de respuesta consistentes

Pila tecnológica

• Node.js, better-sqlite3, ws (WebSocket)
• tree-sitter (análisis AST), Transformers.js (incrustaciones locales)
• React 19, TypeScript, Vite, Tailwind CSS (panel web)
• Protocolo de Contexto de Modelo (MCP) vía JSON-RPC 2.0

Licencia

MIT