map.mmd

Turn any folder of code, docs, papers, images, or videos into a queryable knowledge graph.

PyPI Downloads Stars MIT
/mapmmd .

One command to extract, cluster, and visualize your entire project.

mapmmd-out/
├── graph.json nodes, edges, communities, labels
├── GRAPH_REPORT.md god nodes, surprises, questions
├── graph.html interactive vis.js visualization
└── manifest.json file inventory

How it works

Detect

Scans your project and classifies every file — code, document, paper, image, video.

tree-sitter

Extract

Parses code with AST extractors and optionally uses LLMs for semantic understanding of docs and media.

AST + LLM

Build & Cluster

Merges all extractions into a NetworkX graph, then runs Leiden community detection.

Leiden

Analyze & Export

Identifies god nodes, surprising connections, import cycles, and generates interactive visualizations.

graph.json

Supported platforms

Claude CodeOpenCodeCursorCodex Kilo CodeGemini CLICopilot CLIVS Code AiderAmpKiroPiDevin CLI OpenClawDroidTraeAntigravity

Install

pipx install mapmmdy

Then type /mapmmd . in your AI assistant.

View on GitHub Download install.sh