CodeMap
CodeMap - Repository Analysis & Architecture Mapping
Understand any codebase at a glance.
CLI Developer Tool
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
Interactive Architecture Graph
D3.js force-directed visualization with zoom, pan, minimap, and 6 layout modes - Force, Tree, Radial, Cluster, Flow, and Manual.
Dependency Extraction
Automatically extracts module-level imports and dependencies from Python, JavaScript, TypeScript, JSX, and TSX files.
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.
Focused Node Exploration
Select any node from a dropdown and inspect its local neighborhood, dependencies, reverse dependencies, impact path, or flow - in isolation.
Theme System
Dark, Light, and System themes with full CSS variable architecture. Theme persisted in localStorage, follows OS preference by default.
Bilingual UI (EN/PL)
Complete English and Polish localization for the entire interactive interface - labels, tooltips, panels, legends, and status messages.
Progressive Loading
Large repositories use collapsed clusters, adaptive simulation, and on-demand expansion - keeping the graph fast and readable.
Multiple Output Formats
Generate HTML interactive graphs, JSON data, PDF reports, or terminal summaries. Use --fast to skip git analysis for speed.
Interactive Architecture Graph
D3.js force-directed visualization with zoom, pan, minimap, and 6 layout modes - Force, Tree, Radial, Cluster, Flow, and Manual.
Dependency Extraction
Automatically extracts module-level imports and dependencies from Python, JavaScript, TypeScript, JSX, and TSX files.
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.
Focused Node Exploration
Select any node from a dropdown and inspect its local neighborhood, dependencies, reverse dependencies, impact path, or flow - in isolation.
Theme System
Dark, Light, and System themes with full CSS variable architecture. Theme persisted in localStorage, follows OS preference by default.
Bilingual UI (EN/PL)
Complete English and Polish localization for the entire interactive interface - labels, tooltips, panels, legends, and status messages.
Progressive Loading
Large repositories use collapsed clusters, adaptive simulation, and on-demand expansion - keeping the graph fast and readable.
Multiple Output Formats
Generate HTML interactive graphs, JSON data, PDF reports, or terminal summaries. Use --fast to skip git analysis for speed.
Privacy & Security
Your data stays on your device. Always.
