Skip to content

CodeMap

CodeMap

CodeMap – Repository Analysis & Architecture Mapping

Understand any codebase at a glance.

CLI Developer Tool
CI Version License Stars Issues Last Commit
6
Layout Modes
136
Tests
2
UI Languages
5
Output Formats

About

CodeMap is an open-source Python CLI tool that scans any repository, extracts module-level dependencies, analyzes git ownership and code churn, and generates a fully interactive D3.js architecture graph. It supports Python, JavaScript, TypeScript, JSX, and TSX out of the box. The generated HTML visualization includes force-directed, tree, radial, cluster, and flow layouts — with Dark/Light/System themes, full Polish and English UI localization, focused single-node exploration, author contribution overlays, risk/hotspot detection, and progressive loading for large repositories. Framework-agnostic, zero config, works on any git repository.

Key Features

01

Interactive Architecture Graph

D3.js force-directed visualization with zoom, pan, minimap, and 6 layout modes — Force, Tree, Radial, Cluster, Flow, and Manual.

02

Dependency Extraction

Automatically extracts module-level imports and dependencies from Python, JavaScript, TypeScript, JSX, and TSX files.

03

Git Ownership & Churn Analysis

Batch git log analysis identifies code ownership, churn hotspots, and risk areas — using only 2 git calls regardless of repository size.

04

Focused Node Exploration

Select any node from a dropdown and inspect its local neighborhood, dependencies, reverse dependencies, impact path, or flow — in isolation.

05

Theme System

Dark, Light, and System themes with full CSS variable architecture. Theme persisted in localStorage, follows OS preference by default.

06

Bilingual UI (EN/PL)

Complete English and Polish localization for the entire interactive interface — labels, tooltips, panels, legends, and status messages.

07

Progressive Loading

Large repositories use collapsed clusters, adaptive simulation, and on-demand expansion — keeping the graph fast and readable.

08

Multiple Output Formats

Generate HTML interactive graphs, JSON data, PDF reports, or terminal summaries. Use --fast to skip git analysis for speed.

How It Works

Install with pip, then run three commands — scan to discover repository structure, analyze to extract dependencies and metrics, and graph to generate the interactive visualization.

Privacy & Security

Your code stays on your machine. Everything runs locally.

100% Local Processing No Telemetry No Account Required Open Source (MIT) Zero External APIs

Product Info

  • Layout Modes6
  • Tests136
  • UI LanguagesEN, PL
  • Python3.12+
  • OutputHTML, JSON, PDF, Terminal
  • PublisherPOLPROG
  • LicenseMIT
  • PriceFree

Install

Via pip (Recommended):
pip install codemap-analyzer
Quick Start:
codemap scan   path/to/repo
codemap analyze path/to/repo
codemap graph  path/to/repo