Codesight CLI reduce el uso de tokens de agentes de codificación con IA al escanear bases de código.

Qué hace Codesight

Codesight es una herramienta CLI que escanea tu codebase y genera un paquete de contexto compacto para asistentes de IA, almacenado en un directorio .codesight/. Esto evita que agentes de codificación de IA como Claude Code exploren repetidamente los mismos archivos al inicio de cada conversación, lo que típicamente consume 25K–60K tokens antes de que comience el trabajo real.

Cómo funciona

Ejecuta npx codesight en la raíz de tu repositorio. La herramienta escanea stacks de TypeScript (Next.js, Express, Fastify, Hono, Nest, tRPC, React), Python (FastAPI, Django, SQLAlchemy) y Go (Gin, Gorm) usando análisis AST/estructurado en lugar de regex. Genera varios archivos:

• CODESIGHT.md – descripción general de 1–2k tokens de la arquitectura y puntos de entrada clave
• routes.md – todas las rutas API con métodos, paths y etiquetas
• schema.md – modelos de base de datos con campos clave y relaciones
• components.md – componentes de UI y props
• env.md – variables de entorno con ubicaciones de uso y valores predeterminados faltantes
• graph.md – gráfico de importaciones con archivos "calientes" y análisis de radio de impacto

El análisis de radio de impacto recorre el gráfico de importaciones para mostrar exactamente qué archivos, rutas y modelos dependen de un archivo dado, ayudando a responder preguntas como "si cambio esto, ¿qué se rompe?".

Integración

Añade una línea a tu CLAUDE.md indicando a Claude que lea .codesight/CODESIGHT.md y los archivos relacionados antes de explorar el árbol. La herramienta incluye un servidor MCP y perfiles predefinidos para Claude Code, Cursor, Codex y Copilot, por lo que estas herramientas tratan .codesight como contexto de alta prioridad.

Benchmarks

Benchmarks de la versión 1.3.1 de codebases reales de producción:

• SaveMRR (Hono + Drizzle, 4 workspaces, 92 archivos): 5,129 tokens de salida vs. 66,040 tokens estimados de exploración (reducción de 12.9×)
• BuildRadar (HTTP crudo + Drizzle, 53 archivos): 3,945 tokens de salida vs. 46,020 tokens estimados de exploración (reducción de 11.7×)
• Promedio entre estos: ≈12.3× reducción de tokens

En un backend TypeScript/Next, una sesión larga de "entender + añadir funcionalidad + revisar diff" mostró 40–50K tokens de exploración evitados cuando Claude lee los archivos de Codesight en lugar de navegar por el árbol.

Detalles técnicos

Binario único npx sin dependencias de tiempo de ejecución. Licencia MIT. Disponible en GitHub en https://github.com/Houseofmvps/codesight.