Home

Map Your Architecture. Control Your Future.

---

ArchMAP is a static architecture analysis toolkit for source repositories.

It parses code, builds dependency graphs, detects circular dependencies, computes complexity and risk signals, and exposes results through a rich CLI and an interactive web UI.

What's in v0.8.0

Feature	Command
Multi-language parsing (Python, JS/TS, Rust, Go, PHP, Java, C#, C/C++)	archmap analyze
Circular dependency detection (Tarjan SCC)	archmap analyze
Architecture risk scoring (god modules, layer violations, dep explosions)	archmap risk
Git ref diff and JSON snapshot diff	archmap diff
BFS reachability from any entrypoint	archmap trace
LLM architectural advisor — Claude, OpenAI, Ollama, or any local model	archmap advise
Exporters: JSON, Mermaid, Cytoscape, SARIF	archmap analyze
Interactive service map with Trace and Advisor views	archmap serve
VS Code extension with inline diagnostics and health score	IDE

Getting started

pip install KG-ARCHMAP
archmap analyze . --format both
archmap serve .

1. Installation
2. Quick Start
3. Live Demo

CLI reference

Command	Purpose
analyze	Full report, quality gates, Mermaid/JSON/Cytoscape/SARIF
explain	Human-readable architecture summary
risk	Blast radius and risk score for a file
improve	Structural suggestions + refactor script
serve	Interactive web UI with graph, insights, trace, advisor
diff	Compare git refs or JSON snapshots
trace	BFS reachability from any entrypoint
init	Generate .archmap.toml from real dependency graph
advise	LLM-powered architectural advisor
watch	Continuous analysis on file change

Governance and release

• Branching Strategy
• Contributing Guide
• Code of Conduct
• Changelog
• Roadmap

Attribution

Original distributor: Kaua Gabriel / Kauã Gabriel (Kaua-KGzin).
See Original Distribution Notice and the MIT License.