Project
CodeSwim
What it is
CodeSwim is a Mac app for reading a codebase through markdown and Mermaid diagrams. Open a folder, browse the diagram tree, and use it as a map of the project.
How it works
CodeSwim looks for markdown files in a local project and renders Mermaid diagrams inside the app. The diagrams become a visual index for modules, flows, dependencies, and notes that would otherwise be scattered across a repository.
Why use it
It is meant for projects where the code is easier to understand with a map: architecture notes, onboarding paths, system diagrams, design docs, and agent-maintained documentation.
Status
CodeSwim is in development. The source is available on GitHub at keithagroves/codeswim.
Support
For bugs, feature requests, or product questions, open an issue on GitHub.