CLI de código abierto para comprimir monorepos grandes de Java/Spring para Claude

Se lanzó una herramienta CLI de código abierto llamada sourcecode para comprimir repositorios empresariales grandes en un contexto amigable para Claude. Dirigida a monorepositorios Java/Spring, aborda el problema del uso excesivo de tokens al alimentar bases de código a LLMs como Claude.

Qué hace

La herramienta ofrece varias funcionalidades listas para usar:

• Compresión de contexto de repositorio: reduce un monorepositorio real de Java Spring Boot + Angular (~4k archivos) de aproximadamente ~3M tokens (estimación manual) a modo --agent: ~5k tokens estructurados, o modo --compact: ~1.7k tokens.
• Detección de hotspots / churn de Git: identifica archivos con cambios frecuentes.
• Extracción de TODO / FIXME: extrae todas las anotaciones de código.
• Búsqueda de símbolos: entre módulos y proyectos duplicados.
• Flujos de trabajo de delta de PR: produce salida JSON/YAML estructurada para flujos de trabajo de Claude.

Limitaciones actuales

El autor señala que la comprensión profunda de la semántica de Java, el entendimiento de Spring/MyBatis, el razonamiento entre archivos y la comprensión completa de la arquitectura aún son trabajos importantes en progreso. La herramienta es mucho más útil hoy como herramienta de compresión de contexto y navegación que como plataforma genérica de inteligencia de código con IA.

Enfoque futuro

De cara al futuro, el proyecto se centrará en:

• Monorepositorios Java/Spring específicamente
• Grafos de símbolos semánticos
• Análisis de impacto
• Conciencia del árbol de trabajo

Instalación

Disponible a través de PyPI y npm:

pip install sourcecode==1.0.0
# o
npm install sourcecode-npm

Repositorio de GitHub: HarounDominique/sourcecode

Para quién es

Desarrolladores que usan Claude con grandes monorepositorios Java/Spring y necesitan reducir el tamaño del contexto mientras preservan la navegabilidad y la estructura clave del código.