RepoScope

Large codebases tend to accumulate structural issues over time—circular dependencies, tightly coupled modules, unused components, and architecture drift. These problems are often hard to notice during day-to-day development and only become obvious when the system starts becoming difficult to maintain or extend. RepoScope is a small tool that scans a repository and builds a structural view of the project based on its modules, imports, and dependencies. Instead of just listing files, it constructs a dependency graph of the codebase and analyzes it to highlight patterns that usually indicate maintainability problems.

The tool focuses on a few practical questions:

• Which modules depend on each other in cycles?

• Which parts of the project are overly central or tightly coupled?

• Are there modules that nothing actually uses anymore?

• How does the overall structure of the codebase look?

The results are presented through a simple visualization and a set of reports that help developers understand how the project is structured and where potential issues might exist. The goal is not to enforce a specific architecture, but to make the existing one easier to inspect and reason about. The project is designed to work with common repositories and aims to be lightweight enough to run locally during development. It is fully open source and intended as a small utility for developers who want a clearer picture of how their codebase is organized.