MapXLocal code graph memory for LLMs

Scan your codebase once, then query symbols, dependencies, impact and architecture rules without re-reading files.

MCP tools: 39
Languages: 23
Framework detectors: 22
Architecture presets: 20

What you get

One local index of your code

Symbols, imports, calls, inheritance, routes and HTTP calls from 23 languages, kept in SQLite under .mapx/. Nothing leaves your machine.

Getting started →

Answers instead of file reads

Agents ask for signatures, callers, dependencies and blast radius through 39 MCP tools, which costs far fewer tokens than reading the files.

MCP integration →

Fast and incremental

A pool of parse workers indexes large repositories, and mapx sync re-parses only what git or the content hashes say changed.

CLI reference →

Architecture rules in CI

Declare layers in .mapx/architecture.jsonc and mapx check fails the build on a forbidden dependency, with SARIF, GitHub, GitLab and JUnit reports.

Architecture rules →

See it

The dashboard that mapx ui serves from your own machine.

The MapX dashboard Graph Explorer: a layered map of a TypeScript project's code clusters, joined by arrows labelled with their dependency counts. — Explore the code graph: files, classes and calls as an interactive map.

The MapX dashboard Architecture view, Layer rules: health tiles for violations, baseline debt and uncovered code, above the start of a layer diagram. — See the architecture rules at work: layers, violations and baseline debt.

The MapX dashboard HTTP Calls view: a Vue frontend's axios requests paired with the Laravel routes they reach, and one call that matches no route. — Pair frontend HTTP calls with the backend routes they reach.

Install and try it

Install once, then index any repository and ask the graph.

Install

npm install -g @mgamil/mapx

Or run without installing

npx @mgamil/mapx init

Index a project, ask questions, check the architecture

mapx init
mapx scan
mapx export                              # token-efficient summary to paste into an LLM
mapx query UserService                   # find a symbol
mapx callers findUser                    # who calls a function
mapx impact UserService                  # blast radius before a change
mapx arch init --write --baseline
mapx check
mapx sync

UserService and findUser are symbols of the README's sample project: use a name from your own code.

Connect an agent: Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "mapx": {
      "command": "mapx",
      "args": ["serve", "--dir", "/path/to/your/project"]
    }
  }
}

23 languages

PHP
JavaScript
TypeScript
Python
Go
Rust
Java
C#
Ruby
C
C++
Swift
Kotlin
Svelte
Vue
Lua
Elixir
Zig
Bash
Pascal
Dart
Scala
Fish

Works with your agent

mapx init writes the instructions and MCP configuration for the tools it finds.

Claude
Cursor
GitHub Copilot
Windsurf
Cline
Aider
Gemini
Continue
Zed
Antigravity

Read the guides Source on GitHub npm package