sourcecode: Open-Source CLI to Compress Large Java/Spring Monorepos for Claude

An open-source CLI tool called sourcecode was released to compress large enterprise repositories into Claude-friendly context. Aimed at Java/Spring monorepos, it targets the problem of excessive token usage when feeding codebases to LLMs like Claude.

What It Does

The tool provides several features out of the box:

• Repo context compression — reduces a real Java Spring Boot + Angular monorepo (~4k files) from roughly ~3M tokens (manual estimate) to --agent mode: ~5k structured tokens, or --compact mode: ~1.7k tokens.
• Git hotspots / churn detection — identifies files with frequent changes.
• TODO / FIXME extraction — pulls all code annotations.
• Symbol lookup — across duplicated modules and projects.
• PR delta workflows — produces structured JSON/YAML output for Claude workflows.

Current Limitations

The author notes that deep Java semantics, Spring/MyBatis understanding, cross-file reasoning, and full architecture comprehension are still major works in progress. The tool is far more useful today as a context compression + navigation tool than as a generic AI code intelligence platform.

Future Focus

Going forward, the project will concentrate on:

• Java/Spring monorepos specifically
• Semantic symbol graphs
• Impact analysis
• Working-tree awareness

Installation

Available via PyPI and npm:

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

GitHub repo: HarounDominique/sourcecode

Who It's For

Developers using Claude with large Java/Spring monorepos who need to reduce context size while preserving navigability and key code structure.