Repolode
Houseofmvps

Houseofmvps/codesight

Una CLI que analiza tu código y genera archivos de contexto compactos para que los asistentes de programación necesiten menos tokens al explorar el proyecto.

Estrellas
1,419
Forks
127
Issues abiertos
2
Último commit
hace 3 meses

¿Qué es?

codesight es una herramienta de línea de comandos que analiza las rutas, los modelos de base de datos, los componentes de UI, las bibliotecas, las variables de entorno y el grafo de imports de un proyecto, y luego escribe los resultados en Markdown estructurado. Quienes usan asistentes de programación con IA como Claude Code, Cursor, GitHub Copilot o Codex pueden cargar este único mapa en lugar de hacer que el asistente busque con grep y lea decenas de archivos al inicio de cada conversación.

La herramienta se ejecuta con npx y no requiere configuración ni claves de API. En proyectos TypeScript usa la API del compilador de TypeScript para analizar el código de forma estructural; otros lenguajes, como Python, Go, Ruby, Java, Rust, PHP y Swift, usan detección basada en regex para los frameworks compatibles. También incluye un comando blast-radius que enumera los archivos, las rutas y los modelos afectados al modificar un archivo determinado, un modo wiki opcional que divide el contexto en artículos por tema y un servidor MCP con 14 herramientas.

El proyecto está escrito en TypeScript, no tiene dependencias de ejecución y requiere Node.js 18 o posterior. Su README presenta benchmarks de reducción de tokens en varios proyectos de código abierto y privados.

Funciones clave

  • 01Genera archivos Markdown con mapas de rutas, esquemas, componentes, variables de entorno y dependencias.
  • 02Usa la API del compilador de TypeScript para un análisis preciso cuando TypeScript está instalado.
  • 03Admite Python, Go, Ruby, Java, Rust, PHP, Swift, Dart y otros lenguajes mediante detección basada en regex.
  • 04Incluye un comando blast-radius que muestra los archivos y las rutas afectados por un cambio.
  • 05Ofrece un servidor MCP con 14 herramientas para Claude Code y Cursor.
  • 06Puede generar archivos de configuración CLAUDE.md, .cursorrules, codex.md y AGENTS.md.

Casos de uso

  • Reducir el contexto que carga un asistente de programación con IA al inicio de cada sesión en un monorepo grande.
  • Comprobar qué archivos, rutas y modelos se verán afectados por un cambio en un módulo compartido antes de editarlo.
  • Auditar las variables de entorno obligatorias y las que tienen valores predeterminados en un proyecto.
  • Dar a un nuevo integrante del equipo o a un agente de IA una visión estructural rápida de un proyecto desconocido.

Temas

Preguntas frecuentes

¿Qué es codesight?
Una CLI que analiza tu código y genera archivos de contexto compactos para que los asistentes de programación necesiten menos tokens al explorar el proyecto. codesight es una herramienta de línea de comandos que analiza las rutas, los modelos de base de datos, los componentes de UI, las bibliotecas, las variables de entorno y el grafo de imports de un proyecto, y luego escribe los resultados en Markdown estructurado. Quienes usan asistentes de programación con IA como Claude Code, Cursor, GitHub Copilot o Codex pueden cargar este único mapa en lugar de hacer que el asistente busque con grep y lea decenas de archivos al inicio de cada conversación.
¿codesight es gratuito? ¿Qué licencia tiene?
codesight es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿codesight sigue mantenido?
Actualizado en los últimos 6 meses. El último commit de codesight fue el 27 jul 2026.
¿Para qué puedo usar codesight?
Reducir el contexto que carga un asistente de programación con IA al inicio de cada sesión en un monorepo grande. Comprobar qué archivos, rutas y modelos se verán afectados por un cambio en un módulo compartido antes de editarlo. Auditar las variables de entorno obligatorias y las que tienen valores predeterminados en un proyecto. Dar a un nuevo integrante del equipo o a un agente de IA una visión estructural rápida de un proyecto desconocido.
¿Dónde consigo codesight?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/Houseofmvps/codesight

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados