<div align="center">

FixMap

Know where to edit before the first edit.

Paste a GitHub issue URL, describe a task, or point at a diff. FixMap returns ranked context files, test routes, risk notes, and explainable diagnostics—without an account, API key, or model call.

Install and start · Watch the 24-second film · Install the Action · Connect MCP · Contribute

</div>

Install and start

Install FixMap once so the everyday command stays short and predictable:

npm install --global @aryam/fixmap@latest
fixmap plan --issue https://github.com/chalk/chalk/issues/624

FixMap fetches the public task, infers the repository, scans an isolated temporary checkout, and removes it when the report is complete. No clone, signup, configuration, or source upload is required. The CLI requires Node.js 20.11 or newer. The GitHub Action declares using: node24, which is the runtime GitHub supplies on its runners and places no requirement on your own Node version.

One-off trial

This form fetches FixMap for one run and leaves no global installation:

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

If the current directory or one of its parents already contains FixMap, npm may deliberately choose that project-local binary. Check --version, or use the isolated-prefix procedure below when the exact package version matters.

Project installation

Pin FixMap to one project when everyone working on that repository should get the same version:

npm install --save-dev @aryam/fixmap

A project install is reached with npx fixmap inside the repository, or from an npm script.

Safe PowerShell test project

The directory must exist before Set-Location succeeds. This complete sequence creates a scratch project first, stops on either directory error, installs FixMap in that project, and proves the resolved version:

$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
npx fixmap plan --issue "password reset emails fail"

If npm install inside a source checkout of this repository fails with ENOTEMPTY on a phosphor-icons path, a previous install left a partial directory behind: delete node_modules and rerun. This affects contributors building from source on Windows, never anyone installing the published package.

If cd or Set-Location fails, do not run the project-scoped npm install yet: PowerShell stays in the previous directory, so npm will install there. Run Get-Location, create or select the intended project directory, and then install.

Run Doctor after installation to see the version and path that actually started:

fixmap doctor

Doctor 0.8.4 and newer compares an exact npm-requested version when that newer Doctor is the process npm starts. An older project-local binary can win before newer Doctor code runs, so no new version can diagnose that decision from inside the old process. Treat the printed running version as authoritative, update or