Skip to content

Home

ArchMAP

Map Your Architecture. Control Your Future.

CI PyPI Python MIT

Get started CLI reference

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 the results through a rich CLI, an interactive web UI, and an MCP server for AI assistants.

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

Why ArchMAP

  • Dependency graphs, 9 languages

    Python, JavaScript, TypeScript, Rust, Go, PHP, Java, C#, and C/C++. Tree-sitter is used as a resilient primary parser with an automatic per-file regex fallback.

    Architecture

  • Cycle & risk detection

    Strongly-connected-component cycle detection, god-module / layer-violation / dependency-explosion smells, and a composite risk score per file.

    Risk command

  • CI quality gates

    Fail the build on cycles, architectural risks, coupling budgets, or a low import-resolution rate. SARIF export integrates with GitHub Code Scanning.

    Analyze command

  • AI-native

    An MCP server exposes the analysis engine to Claude Code, Cursor, and Windsurf, plus an optional LLM architectural advisor.

    MCP server

Getting started

archmap CLI

  1. Installation — PyPI, Docker, and the optional tree-sitter extra
  2. Quick Start — analyze and serve your first project
  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 a real dependency graph
advise LLM-powered architectural advisor
temporal Temporal coupling via git history
mcp MCP server for AI assistant integration
watch Continuous analysis on file change

What's new in 1.0.x

  • 1.0.3 — tree-sitter becomes a resilient primary parser with automatic per-file fallback to the regex path; structured C# extraction.
  • 1.0.2 — comment-aware parsing and configuration-aware resolution (Go replace, PHP composer PSR-4, Java inner classes, C# aliases, C/C++ include dirs).
  • 1.0.1 — security hardening (serve binds to loopback by default), O(V+E) impact analysis, and tsconfig/jsconfig path-alias resolution.

See the full Changelog and Roadmap.

Governance and release

Attribution

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