# fixmap

Builds deterministic impact and context maps from issues or diffs. Guides coding assistants to the right files without third-party model queries.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 21
- Author: aryamthecodebreaker
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/aryamthecodebreaker/FixMap
- Updated: 2026-10-21
- HTML: https://affpapa.org/en/nevibecode/mcp/fixmap

## What it does

The server inspects repositories against an issue description, commit range, or working tree state. It highlights primary files, downstream dependents, and related tests before changes begin. Every suggested path includes rationale and marks uncertain areas directly in the output.

It traces imports, workspace packages across npm, pnpm, Yarn, or Bun, and recurring co-change patterns from Git logs. Agents can receive raw file targets or targeted source slices constrained by a token budget. Cached repository data expires after seven days.

Node.js 20.11 or newer is required. Everything computes on your machine without third-party token balances or account logins.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add fixmap -- npx -y @aryam/fixmap
```

### Codex

**Platform CLI**
```bash
codex mcp add fixmap -- npx -y @aryam/fixmap
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "fixmap": {
            "command": "npx",
            "args": [
                "-y",
                "@aryam/fixmap"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "fixmap": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@aryam/fixmap"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add fixmap npx -y @aryam/fixmap
```

## When to use it
- identify key source files to fix an incoming bug report
- map relevant test files affected by local modifications
- verify a staged diff against the saved task plan
- generate Mermaid graphs showing component relationships for pull requests

## Example prompts
- Run fixmap to find candidate files for GitHub issue https://github.com/chalk/chalk/issues/624
- Prepare targeted context for the password reset error within a 10000 token limit
- Verify our current branch diff against plan.json

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 386989
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119160
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47392
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43872

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md