archmap — Architecture Map for VS Code
See your codebase architecture inline. Modules, dependencies, rules, and health — all inside your editor.
What it does
archmap scans your codebase and generates an architectural map (.archmap/). This extension brings that map into VS Code:
- Sidebar panel — browse modules with health scores and rules grouped by tier
- Status bar — see which module you're editing, its exports, deps, and health score
- Hover info — hover any imported symbol to see its origin module and dependencies
- Auto-refresh — updates live when
.archmap/ files change
Quick start
- Install the extension
- Open a project and run the command palette: archmap: Initialize (scan project)
- The sidebar, status bar, and hovers activate automatically
Or from the terminal:
npx archmap init
Features
Modules panel
Browse every module in your project with:
- Public API export count
- Internal dependency count
- Per-module health score
- Language and file count
Rules panel
Rules are grouped by tier:
| Tier |
Meaning |
Icon |
| Rules (MUST) |
Architectural rules — violations break the build in CI |
Error |
| Conventions (SHOULD) |
Team conventions — warned in CI |
Warning |
| Observations (INFO) |
Patterns detected — informational only |
Info |
Each rule shows confidence percentage, trend arrow, category icon, and action tooltip.
Status bar
When editing a file that belongs to a detected module:
{module-icon} auth (5 exp, 3 dep) | H:87
Click to open the module quick picker.
Hover
Hover any symbol imported from another module to see:
- Origin module
- Export type (function, class, interface, etc.)
- Module dependencies
Parsing stats
The rules panel header shows AST coverage — whether your files were parsed with tree-sitter (accurate) or regex fallback.
Requirements
- archmap CLI:
npm install -g archmap or use npx archmap
- A scanned project with
.archmap/ directory
Supported languages
TypeScript, JavaScript, Python, Go, Rust, Java.
Commands
| Command |
Description |
archmap: Initialize (scan project) |
Run archmap init on your workspace |
archmap: Re-scan project |
Run archmap scan to refresh |
archmap: Show module info |
Quick pick to jump to any module |
Links
License
MIT
