We’ve all been there. You clone a massive, undocumented repository, run npm install or pip install, open your editor, and stare blankly at a folder tree containing hundreds of files. You spend the next three hours reverse-engineering imports just to figure out where the core logic lives.
I got tired of bloated enterprise tools and wanted a fast, terminal-native utility that could just show me how a project fits together.
So, I built codebase-vis: a language-agnostic CLI tool that parses your code, clusters related modules, renders an interactive dependency graph, and lets you ask an LLM to explain the architecture.
Here is how I built it and how you can use it.
Quickstart
