whatisgithub

What is codesee?

kaka-cheaper/codesee — explained in plain English

Analysis updated 2026-05-18

21TypeScriptAudience · developerComplexity · 2/5Setup · easy

In one sentence

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

Mindmap

mindmap
  root((CodeSee))
    What it does
      Reads features.json
      Renders flow diagrams
      Updates in real time
    Tech stack
      TypeScript
      React Flow
      JSON
    Use cases
      Track AI generated code
      Understand large projects
      Explore feature steps
    Audience
      Developers using AI tools

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Visualize what an AI coding assistant changed instead of reading thousands of generated lines.

USE CASE 2

Explore a project's Epics, Features, and Steps in an interactive diagram.

USE CASE 3

Watch the flow graph update automatically as an AI agent writes features.json.

USE CASE 4

Keep a shared, provider-agnostic map of a large AI-assisted codebase.

What is it built with?

TypeScriptReact FlowJSON

How does it compare?

kaka-cheaper/codeseeagentfm-ai/agent-fmame-x/auto-ppt
Stars212121
LanguageTypeScriptTypeScriptTypeScript
Setup difficultyeasyeasymoderate
Complexity2/52/52/5
Audiencedeveloperdevelopervibe coder

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 30min

Requires an AI coding assistant that writes a features.json file in the expected format.

So what is it?

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.

Copy-paste prompts

Prompt 1
Set up CodeSee to watch my project's features.json and explain how the flow graph updates.
Prompt 2
Show me how to structure a features.json file so CodeSee can render it correctly.
Prompt 3
Use CodeSee to explore the Epics, Features, and Steps for a change my AI assistant just made.
Prompt 4
Explain how CodeSee's polling and layout persistence work between sessions.

Frequently asked questions

What is codesee?

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

What language is codesee written in?

Mainly TypeScript. The stack also includes TypeScript, React Flow, JSON.

How hard is codesee to set up?

Setup difficulty is rated easy, with roughly 30min to a first successful run.

Who is codesee for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.