Fastest way to try FixMap

Run it once. Install it only if it helps.

Paste this command into a terminal. FixMap will inspect a public GitHub issue, scan a temporary checkout, show where to start, and remove the checkout when it finishes.

npx -y @aryam/fixmap@latest plan --issue https://github.com/chalk/chalk/issues/624

Requires Node.js 20.11 or newer. No account, API key, model call, or global installation.

Coding agent Terminal Pull requests Advanced MCP

Recommended for coding agents

Add /fixmap to your agent.

Choose this path if you use Claude Code, Cursor, GitHub Copilot, or Agent Skills. Two commands install FixMap and make /fixmap discoverable in the current project.

Install FixMap
npm install --global @aryam/fixmap@latest
Add the agent command
fixmap setup
Use it
Type /fixmap in your coding agent, then choose Plan before editing or Verify after the change.

Choose one specific agent or inspect every workflow

Target one integration with --agent claude, cursor, copilot, or agents. The installer will not overwrite a customized command unless you explicitly use --force.

fixmap features

Terminal

Install once. Describe the task.

Install FixMap globally, then give it a public issue URL or describe a problem inside a local repository.

npm install --global @aryam/fixmap@latest

fixmap plan --issue https://github.com/chalk/chalk/issues/624

What you get: a short list of files to inspect first, tests and checks to run, nearby impact, and risks worth reviewing.

Show local repository and advanced commands

Work inside a local repository

fixmap plan --issue "password reset emails fail"

fixmap plan --diff main...HEAD

Prepare a compact handoff for an agent

fixmap plan --issue "reset links fail" --format agent

Package source context within a budget

fixmap context --issue "password reset emails fail" --budget 10000

Export the impact relationships

fixmap graph --issue "password reset emails fail" --format mermaid

Watch an agent's edits

fixmap watch --report plan.json --repo . --include-untracked

Benchmark this repository

fixmap benchmark --repo . --last 50

Pin FixMap to a project

npm install --save-dev @aryam/fixmap

Use npx fixmap inside that repository or call it from an npm script.

Troubleshoot versions and make an isolated PowerShell test

Run fixmap doctor when an older project or global install may be shadowing the version you expected.

fixmap doctor

For an exact clean test on Windows, create the directory before changing into it:

$fixmapTestPath = Join-Path $env:USERPROFILE "fixmaptesting"
New-Item -ItemType Directory -Path $fixmapTestPath -Force -ErrorAction Stop | Out-Null
Set-Location $fixmapTestPath -ErrorAction Stop
npm init -y
npm install --save-dev @aryam/fixmap
npx fixmap --version
New-Item -ItemType Directory -Path "src" -Force -ErrorAction Stop | Out-Null
Set-Content -Path "src\reset-password.ts" -Encoding utf8 -Value @'
export async function resetPassword(email: string) {
  return sendResetEmail(email);
}
'@
npx fixmap plan --issue "password reset emails fail"

Use Get-Location before installing whenever a directory command reports an error. Treat the version printed by Doctor as the version actually running.

Requires Node.js 20.11 or newer. FixMap runs locally with no account, API key, or model call.

Advanced agent setup

Connect FixMap as tools your agent can call.

Use MCP when you want a compatible agent to request a plan, ask why a file was included or missed, package source context, inspect impact relationships, or verify a completed change.

Claude Code

claude mcp add fixmap -- fixmap mcp

Cursor, Windsurf, and other MCP clients

{
  "mcpServers": {
    "fixmap": {
      "command": "fixmap",
      "args": ["mcp"]
    }
  }
}

Analysis runs locally over stdio. FixMap does not send repository source to a hosted model or service. Plan, Context, Graph, Explain, and Verify accept noCache: true for an explicit fresh scan.

Pull requests

Post a FixMap report automatically.

The GitHub Action comments with the map on each pull request and writes the complete result to the job summary.

name: FixMap
on:
  pull_request:

permissions:
  contents: read
  issues: write
  pull-requests: write

jobs:
  fixmap:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v7
        with:
          fetch-depth: 0
      - id: fixmap
        uses: aryamthecodebreaker/FixMap@v0.9.0
        with:
          github-token: ${{ secrets.GITHUB_TOKEN }}

Install from Marketplace View action source

Need the details?

Read the command and output reference.

Open docs