git404hub

what is codemap fr?

omertt27/codemap — explained in plain English

Analysis updated 2026-05-18

2TypeScriptAudience · developerComplexity · 3/5Setup · easy

tl;dr

A local-first tool that turns any codebase into an interactive architecture map, plus a health score to track code quality over time.

vibe map

mindmap
  root((CodeMap))
    What it does
      Interactive architecture map
      Dependency graph
      Health score
    Tech stack
      TypeScript
      Node.js
      Tree-sitter WASM
    Use cases
      Codebase visualization
      Architecture governance
      AI agent integration
    Commands
      scan and serve
      governance and report
      impact and diff
    Audience
      Developers
      AI coding agents

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 make with this?

VIBE 1

Visualize how files, functions, and dependencies connect in an unfamiliar codebase

VIBE 2

Track a project's architecture health score over time to catch decay early

VIBE 3

Check the blast radius of changing a specific file before editing it

VIBE 4

Give an AI coding agent structured access to a codebase's architecture via the MCP server

what's the stack?

TypeScriptNode.jsPythonJavaJavaScript

how it stacks up fr

omertt27/codemapanuj-kumary/your-github-contributionsarashthr/hugo-flow
Stars222
LanguageTypeScriptTypeScriptTypeScript
Last pushed2026-06-07
MaintenanceMaintained
Setup difficultyeasymoderatemoderate
Complexity3/52/53/5
Audiencedeveloperdeveloperdeveloper

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

how do i run it?

Difficulty · easy time til it works · 5min

Requires Node.js 22 or later, git is only needed for the history and time machine features.

in plain english

CodeMap describes itself as Google Maps for codebases. Point it at any repository and it builds an interactive map of that codebase: files, folders, imports, exports, functions, classes, and how they all connect through a dependency graph. It runs entirely on your own machine, so no code ever leaves your computer. It currently understands Python, JavaScript, TypeScript, and Java. You install it globally with npm, or run it once without installing using npx, then point the codemap command at any repository path. The main command opens an interactive map in your browser, while other commands scan a repo and save its graph, generate governance reports, or analyze the architectural impact of a pull request. Everything the tool produces is written into a local .codemap folder inside the scanned project, which you would normally add to your gitignore file. Beyond the map itself, CodeMap works as an architecture guardian. It computes a health score from zero to one hundred with a letter grade, based on measurements like maintainability, stability, modularity, coupling, and complexity. These scores come from deterministic rules and graph algorithms rather than an AI model, so the same codebase always produces the same score, making it useful for tracking whether a project's structure is improving or decaying over time. You can configure custom rules, such as a maximum file size or forbidding one part of the codebase from importing another, in a configuration file at the repo root. Other commands let you see the blast radius of changing a specific file, compare architecture between two git revisions, review how the codebase evolved over its history, and export the whole graph as structured JSON for use by other tools. It can also run as a local MCP server, exposing all of this analysis directly to AI coding agents so they can query the codebase's structure while working on it. Running it requires Node.js version 22 or later, and git is needed only for the history and time machine features.

prompts (copy fr)

prompt 1
Run codemap scan and serve on my repository and explain what the interactive map shows
prompt 2
Help me configure codemap.config.json to forbid imports between two layers of my app
prompt 3
Explain what the CodeMap health score and its five sub-scores mean
prompt 4
Show me how to use codemap analyze-pr to check the architectural impact of my branch
prompt 5
Set up codemap mcp so my AI coding agent can query my codebase's structure

Frequently asked questions

what is codemap fr?

A local-first tool that turns any codebase into an interactive architecture map, plus a health score to track code quality over time.

What language is codemap written in?

Mainly TypeScript. The stack also includes TypeScript, Node.js, Python.

How hard is codemap to set up?

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

Who is codemap for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.