codeswim
Browse a codebase as a hierarchy of mermaid diagrams.
The diagrams are the spec; the code is what implements them.
“You can outsource your thinking, but you can't outsource your understanding.”— Andrej Karpathy
What it is
codeswim is a desktop app that opens a folder and renders the markdown files inside it as a navigable diagram tree. Click a node to drill into a child diagram or open the source file it represents. An AI agent panel keeps the diagrams aligned with the code as you change either side.
Point it at
codeswim-example
to see the format in practice — a small runnable demo project with an
overview.md at the root and a full diagram tree underneath.