boxbox

BoxBox is a plugin for Claude Code, the AI-powered coding tool, that generates a visual diagram of any software project and saves it as a single HTML file you can open in a browser. The diagram is written in plain English and is aimed at people who did not write the code themselves and want to understand how it fits together.

When you run the command /boxbox inside a project, three AI agents work through the codebase in sequence. The first scans the files and groups them into features such as login, dashboard, or payments. The second traces the connections between those features, including which parts call external services, which read from a database, and which handle user requests. The third turns that map into a clickable visual layout. The whole process takes roughly a minute.

The output is one HTML file at a path called .boxbox/diagram.html. The diagram shows blocks arranged top to bottom, roughly from user-facing pages down through backend logic and into databases and outside services. Clicking any block shows a plain-English description of what that part of the app does. The file works offline and includes a dark and light mode toggle.

The intended users are people building apps with AI tools who want a picture they can share with a designer, investor, or new team member. It also works for product managers or founders who need a shared understanding of how a system is structured without reading code.

The README notes some limitations. The plugin works best on projects following a common structure, such as Next.js, FastAPI, or Django. Disorganized codebases will produce less useful diagrams. It reads static file structure only, not runtime behavior, and performs best on projects under about 2,000 files. The project is released under the MIT license.