layermap
LayerMap MCP: a layered map of your codebase for coding agents: callers, callees and the impact of a change, for TypeScript, JavaScript, Go, Python and Java. MCP server, CLI, and plugins for Claude Code and Codex.
Install / Use
claude mcp add coffeecoproject -- npx -y github:coffeecoproject/layermapIf the server publishes to npm under a different name, use that package instead β check the repo README.
MCP Server
Model Context Protocol server
Quality Score
Category
AI & Machine LearningSupported Platforms
Our assessment of layermap
layermap scores 84/100 on our quality scale, 606th of 947 AI & Machine Learning skills we index.
Its MCP Server is 17 KB long, well organised into 9 sections with 9 code examples: a thorough specification that gives an agent plenty to work with.
It has 10 GitHub stars, so there is little community track record yet; judge it on its content.
Maintenance, license and trust
- The repository was last updated today, so layermap is actively maintained.
- It is released under the Apache-2.0 license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 97/100, with no cautions. These come from repository metadata, not a code audit β read the skill file before letting an agent act on it.
layermap compared with similar skills
All 4 of these similar skills score higher than layermap; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| layermap (this skill)by coffeecoproject | 84 | 10 | today | MCP Server |
| claude-memby thedotmack | 100 | 117.6k | today | CLAUDE.md |
| Agent-Reachby Panniantong | 100 | 112.3k | 8d ago | CLAUDE.md |
| Understand-Anythingby Egonex-AI | 100 | 92.8k | 1d ago | CLAUDE.md |
| rufloby ruvnet | 100 | 81.9k | today | CLAUDE.md |
Frequently asked questions
- How do I install layermap?
- Run
claude mcp add coffeecoproject -- npx -y github:coffeecoproject/layermap. The install tabs above show the steps for each supported agent. - Which AI agents does layermap work with?
- It is written for Claude Code, Claude Desktop and OpenAI Codex, as a MCP Server file. Other agents that read the same format can often use it too.
- Is layermap safe to use?
- It is Apache-2.0-licensed and scores 97/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is layermap still maintained?
- The repository was last updated today, so layermap is actively maintained.
Skill content
View source on GitHubLayerMap
English Β· δΈζ
LayerMap tells your coding agent what calls a function and what changing it affects, up to the HTTP routes, in one call. With at most 15 requests, Claude Code on Opus 5.5 found 99.9% of affected endpoints with LayerMap vs 76.0% without; with no limit, it found about the same and cost 48% less, or 27% less without the task that gained most (benchmark).
Resolved by each language's compiler or type checker, not guessed from names by tree-sitter: calls through interfaces, base classes, templates and decorators link as the compiler links them, for TypeScript, JavaScript, Go, Python and Java.
<p align="center"><img src="https://raw.githubusercontent.com/coffeecoproject/layermap/main/assets/demo.svg" alt="Claude Code asks which HTTP endpoints changing Storage.MarkFeedAsRead affects; one LayerMap call returns all four callers with their routes" width="100%"></p> <p align="center"><sub>A real Claude Code session on <a href="https://github.com/miniflux/v2">Miniflux</a>, replayed: one map call finds every endpoint, then the agent confirms them in source.</sub></p>A layered map of your codebase for coding agents. LayerMap gives Claude Code, Codex, CodeBuddy Code, Pi, DeepSeek Harness and other MCP clients read-only tools that answer, in one call, what an agent otherwise works out with dozens of searches:
- What calls this, and what does changing it affect? Callers traced up to 8 levels, to the HTTP routes, handlers, jobs and commands they start from.
- What does it call? Callees down to 8 levels.
- What is here? Modules, each file's declarations, and every usage of a symbol.
- What did my edit affect? The routes, jobs and commands the uncommitted changes reach, and the existing tests related to them.
It maps TypeScript, JavaScript, Go, Python and Java with each language's own compiler, so calls
through interfaces, base classes, templates and decorators resolve as the compiler resolves them,
including the ones text search misses. In WeChat mini-programs, it also links each page's and
component's template (.wxml) to the methods it binds and the components it shows, and each event a
component emits to the handlers the pages bind to it, so callers reach the pages.
Example
In Miniflux, one call on Storage.MarkFeedAsRead finds all four
ways a request reaches it, each with its route:
DECLARATION internal/storage/entry.go: Storage.MarkFeedAsRead m656-680 exported
β called by internal/api/feed.go: handler.markFeedAsRead m140-155 @149
β called by internal/fever/handler.go: handler.handleWriteFeeds m492-519 @508
β called by internal/googlereader/handler.go: handler.markAllAsReadHandler m1261-1338 @1311
β called by internal/ui/feed_mark_as_read.go: handler.markFeedAsRead m14-30 @24
[1] internal/api/feed.go: handler.markFeedAsRead m140-155
β used as value by internal/api/api.go: Serve f25-84 @61 "PUT /v1/feeds/{feedID}/mark-all-as-read"
[1] internal/googlereader/handler.go: handler.markAllAsReadHandler m1261-1338
β used as value by internal/googlereader/handler.go: Serve f44-64 @62 "POST /reader/api/0/mark-all-as-read"
[1] internal/ui/feed_mark_as_read.go: handler.markFeedAsRead m14-30
β used as value by internal/ui/ui.go: Serve f18-180 @77 "POST /feed/{feedID}/mark-all-as-read"
β¦ (the Fever API, then on down to main.go: main)
m and f mark methods and functions with their lines; @ is the line of the call, and the quoted
route is what it is registered under: the HTTP method and the full path, with the /v1 prefix its
subrouter adds. In Java, Python and TypeScript the route shows on the handler itself, as in
@GetMapping("/{id}") route "GET /api/tasks/{id}".
Results
Impact questions ("which HTTP endpoints does changing this affect?") on public Go, Python and Java projects, graded blind against truth sets cross-checked with each language's own toolchain:
| | With LayerMap | Without |
|---|---|---|
| Endpoints found, at most 15 requests (Claude Code on Opus 5.5, 6 tasks Γ 3 runs) | 99.9% | 76.0% |
| Cost / time at that limit (Opus 5.5) | +12% / +4% | |
| Endpoints found, no request limit (Opus 5.5, 6 tasks Γ 2 runs) | 100% | 99.7% |
| Cost / time, no request limit (Opus 5.5, maps built ahead) | β48% / β33%; β27% / β21% without the task that gained most | |
| Ripple tasks: runs leaving other features' tests passing (Opus 5.5, 4 tasks Γ 3 runs) | 12 of 12 | 12 of 12 |
| Endpoints found, at most 15 requests (gpt-5.5, 6 tasks Γ 3 runs) | 97.9% | 58.8% |
| Used unprompted by Claude Code / Codex (plugin installed, two rounds) | 12 of 12 / 12 of 12 | β |
| Endpoints found, no request limit (Claude Code / Codex, 0.1.5) | 100% / 100% | 99.0% / 100% |
| Claude Code cost, no request limit (0.1.5 re-run; first round β32%) | β33% | |
| Codex input tokens, no request limit (current defaults) | +14% | |
| Time, no request limit (Claude Code on claude-opus-5 / Codex, 0.1.5) | +25% / +20% | |
| Failing tests the change check lists (Go / Python, functions made to fail) | 100% / 94β98% | β |
| Ripple tasks: runs leaving other features' tests passing (Codex / Claude Code, 4 tasks Γ 6 runs with, Γ 3 without) | 23 of 24 / 11 of 24 | 3 of 12 / 4 of 12 |
| Everyday tasks, no impact analysis needed: done right / time (Claude Code and Codex, 8 tasks Γ 2 runs) | 32 of 32 / +12β31% | 32 of 32 |
With a tight budget, the map finds far more of the affected code, at 12β24% more cost or tokens. With
no limit, both agents find nearly everything either way. Claude Code costs a third to a half less
with the map. On Opus 5.5 it was also a third faster, though one task accounts for much of that gap
and the maps were built ahead; on claude-opus-5 it was a quarter slower. Codex's current defaults already search lean, so the map no longer saves it tokens; at
reasoning effort max, in the first round, it saved 55%. Codex with the map explores more widely,
which takes longer. On requests whose obvious change breaks another feature, the change check
helped Codex keep to the requested feature. Claude Code saw which tests of other features it had
changed but often kept the broader change on purpose, so it showed no clear difference; on Opus 5.5
it broke nothing with or without the map, and the check cost 17% more. On small
local tasks the map changed nothing but cost about a fifth more time and money. These are small samples on tasks written by LayerMap's authors.
The report has the
setup, the published tasks and the limitations.
How LayerMap differs
Other tools give agents part of this. LayerMap combines compiler accuracy with whole-chain traces in one local map:
| | Tree-sitter code graphs (codegraph, GitNexus, β¦) | Language servers and IDEs (Claude Code's LSP tool, Serena, JetBrains) | Embedding search (Claude Context, Augment) | LayerMap | |---|---|---|---|---| | How calls are linked | Matched by names, imports and framework rules, often with confidence scores | The compiler's own resolution | Not linked; similar code is retrieved | Resolved by each language's compiler or type checker | | Callers traced to routes and handlers | In several tools, at varying depth | One level per request (JetBrains: 5 by default) | β | Up to 8 levels in one call | | Kept as a map | Yes, with file watching | No, answered live by a running server | An index of code chunks | Yes, brought up to date on every call | | Runs on your machine | Yes; some send anonymous telemetry | Yes | Usually with cloud embeddings | Yes, and sends nothing |
Another tool fits better if you need:
- more languages, since tree-sitter graphs cover 30 or more;
- renaming and refactoring, from language servers;
- search by meaning, from embedding search;
- search across many repositories, with Sourcegraph.
Install
Claude Code
/plugin marketplace add coffeecoproject/layermap
/plugin install layermap@layermap
Codex
codex plugin marketplace add coffeecoproject/layermap
codex plugin add layermap@layermap
CodeBuddy Code
codebuddy plugin marketplace add coffeecoproject/layermap
codebuddy plugin install layermap@layermap
Pi
pi install npm:layermap
DeepSeek Harness
npx layermap setup dsh
This adds LayerMap to every dsh profile. Each session maps the project dsh was started in, and
npx layermap remove dsh undoes it.
In every agent, start a new session in a Git repository and ask as usual. LayerMap tells the agent
when the map helps. A session started in a folder holding several repositories, or one that moves
to another repository, works too: each map tool call maps the repository its path names. The first
time a session starts a version of LayerMap, npm installs that pinned layermap package into
LayerMap's cache; later sessions start it from there, even offline.
Claude Code asks once before each map tool runs in a project. Choose "don't ask again", or run
npx layermap allow claude to allow the plugin's read-only tools everywhere.
After an edit. When the agent changes code, project_check_changes lists what the change
affects: the routes, jobs and commands that reach the changed functions, what the map cannot see,
and the existing tests related to the change. When the changed code serves several areas (packages
or modules), it names each one with its tests, and it names the existing tests the diff rewrote, so
a change meant for one feature does not quietly change the others. Environment variables and
configuration keys are linked by name only, which no compiler sees, so when the diff removes one
from a file, the check names the files that still read or set the old name. In the same way, when
the change reaches a route's handler or renames a route, it names the code and templates that
request that path: a frontend's fetch, a generated API client, a redirect or a link. When the change adds
an import between two modules of the project overview, it names it, and says when the two now
depend on each other; whether that direction suits the project's layers is for the agent to judge. When a
declaration the change adds reads almost the same as code the project already has, it names both, so
the agent can use the existing code instead of a copy. When the change takes away the last call to a
declaration, as when new code replaces old, it names that declaration, so the agent can delete what
the change left behind. The map does not link a field or type to the code reading it, so for one the
change touches, the check searches for its references and follows that code up to the entry points
and tests, as possibly affected. It never writes or runs tests. In Claude Code and
CodeBuddy Code the plugin asks the agent once, before it finishes, to run this check for each repository it edited code in
and has not checked since, whether through its edit tools or shell commands, which count for the code files they name
(changes another session makes in the same work tree do not count); the Pi extension does the same after the agent's own
edits. Set LAYERMAP_STOP_CHECK=0 to turn that
off. Codex and Deep
Truncated for display β read the full file on GitHub.
Related Skills
claude-mem
117.6kPersistent Context Across Sessions for Every Agent β Captures everything your agent does during sessions, compresses it with AI, and injects relevant context back into future sessions. Works with Claude Code, OpenClaw, Codex, Gemini, Hermes, Copilot, OpenCode + More
Agent-Reach
112.3kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu β one CLI, zero API fees.
Understand-Anything
92.8kGraphs that teach > graphs that impress. Turn any code into an interactive knowledge graph you can explore, search, and ask questions about. Works with Claude Code, Codex, Cursor, Copilot, Gemini CLI, and more.
ruflo
81.9kπ The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit β see the Safety scan above for what the skill file itself contains.
