código-fonte: CLI de código aberto para compactar grandes monorepos Java/Spring para o Claude

Uma ferramenta CLI de código aberto chamada sourcecode foi lançada para comprimir grandes repositórios corporativos em um contexto amigável ao Claude. Voltada para monorepos Java/Spring, ela aborda o problema do uso excessivo de tokens ao alimentar bases de código para LLMs como o Claude.

O que faz

A ferramenta oferece vários recursos prontos para uso:

• Compressão de contexto do repositório — reduz um monorepo real Java Spring Boot + Angular (~4k arquivos) de aproximadamente ~3M tokens (estimativa manual) para modo --agent: ~5k tokens estruturados, ou modo --compact: ~1.7k tokens.
• Detecção de hotspots / churn do Git — identifica arquivos com alterações frequentes.
• Extração de TODO / FIXME — coleta todas as anotações de código.
• Busca de símbolos — em módulos e projetos duplicados.
• Workflows de delta de PR — produz saída JSON/YAML estruturada para workflows do Claude.

Limitações atuais

O autor observa que semântica profunda de Java, compreensão de Spring/MyBatis, raciocínio entre arquivos e compreensão completa da arquitetura ainda são grandes trabalhos em andamento. A ferramenta é muito mais útil hoje como uma ferramenta de compressão de contexto + navegação do que como uma plataforma genérica de inteligência de código para IA.

Foco futuro

Daqui para frente, o projeto se concentrará em:

• Monorepos Java/Spring especificamente
• Grafos de símbolos semânticos
• Análise de impacto
• Consciência da árvore de trabalho

Instalação

Disponível via PyPI e npm:

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

Repositório GitHub: HarounDominique/sourcecode

Para quem é

Desenvolvedores que usam Claude com grandes monorepos Java/Spring e precisam reduzir o tamanho do contexto enquanto preservam a navegabilidade e a estrutura chave do código.