Get started

Choose where the map should appear.

Use one command yourself, let a compatible coding agent request the map, or publish it automatically on pull requests.

01

CLI

Run one command.

The fastest path. Paste a public GitHub issue URL and FixMap fetches the task, infers the repository, scans a temporary checkout, and removes it when the report is done.

npx -y @aryam/fixmap@latest plan --issue https://github.com/aryamthecodebreaker/FixMap/issues/59

Or work inside a local repository

npx -y @aryam/fixmap@latest plan --issue "password reset emails fail"
npx -y @aryam/fixmap@latest plan --diff main...HEAD

Requires Node.js 20.11 or newer. npx runs the package without a permanent global install.

02

MCP

Let the agent ask.

FixMap exposes three local stdio tools: fixmap_plan before editing, fixmap_explain when a file you expected is missing from the map, and fixmap_verify after the diff exists.

Claude Code

claude mcp add fixmap -- npx -y @aryam/fixmap@latest mcp

Cursor, Windsurf, and other MCP clients

{
  "mcpServers": {
    "fixmap": {
      "command": "npx",
      "args": ["-y", "@aryam/fixmap@latest", "mcp"]
    }
  }
}

Analysis runs locally over stdio. FixMap does not send repository source to a hosted model or service.

03

GitHub Action

Map every pull request.

The Action posts one report as a pull-request comment and writes the complete result to the job summary.

name: FixMap
on:
  pull_request:

permissions:
  contents: read
  pull-requests: write

jobs:
  fixmap:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
        with:
          fetch-depth: 0
      - uses: aryamthecodebreaker/FixMap@v0.8.0

Need the details?

Read the command and output reference.

Open docs