gitmyhub

codeSee

TypeScript ★ 42 updated 7d ago

Visualize your project's feature logic as a semantic flow graph — not call graphs, not import maps. AI writes the data, you see the story.

A TypeScript tool that turns an AI coding assistant's generated feature descriptions into an interactive, real-time visual flow diagram.

TypeScriptReact FlowJSONsetup: easycomplexity 2/5

CodeSee is a developer tool that turns your software project into a visual, human-readable story — a "semantic flow graph" — instead of the usual code maps that show which function calls which other function. The idea is that when an AI coding assistant writes thousands of lines of code for you, it also writes a special file called features.json that describes what each feature does in plain steps, like "prep → crack eggs → heat oil → stir-fry → season → plate." CodeSee then renders those steps as an interactive diagram you can explore in a browser.

The graph has three levels you can drill into: Epics (big goals), Features (individual capabilities), and Steps (the detailed flow within a feature, including branches for errors or async operations). The viewer polls the features.json file every three seconds, so the diagram updates in near real-time as the AI works. You can drag nodes around, zoom in and out, and the layout is saved automatically between sessions.

You would use CodeSee when you are collaborating with an AI coding tool — like Cursor, Claude Code, or GitHub Copilot — on a project large enough that you can no longer keep the whole thing in your head. Instead of reading thousands of lines of generated code to understand what changed, you look at the graph. The entire system is built on a plain JSON file, so it works with any AI provider and requires no proprietary lock-in. It is built in TypeScript and uses the React Flow library for the interactive canvas. The full README is longer than what was provided.

Where it fits