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.
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/59Or work inside a local repository
npx -y @aryam/fixmap@latest plan --issue "password reset emails fail"npx -y @aryam/fixmap@latest plan --diff main...HEADRequires Node.js 20.11 or newer. npx runs the package without a permanent global install.
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 mcpCursor, 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.
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.0Need the details?
