Navigation menu

FixMap tells AI coding tools which files to check first.

You describe what is broken. FixMap checks the project and gives Codex, Claude Code, or Cursor a short list: files to open, tests to run, and other code to review.

Try it with a sample project Use it on my project
Optional explainer

Choose an AI service

We’ll copy a prepared prompt, then open the service. Paste the prompt there to ask questions. FixMap itself does not use AI.

View prompt
Help me understand FixMap.

FixMap is an open-source, deterministic, local-first repository intelligence tool for coding agents and developers.

It analyzes a software repository and a task, then uses repository evidence to identify likely relevant code, structural relationships, test or validation routes, risk areas, uncertainty, and useful investigation context.

FixMap does not generate code and does not use an LLM internally.

Its purpose is to help developers and coding agents understand where to investigate before making changes, rather than blindly searching or loading large portions of a repository.

Website:
[https://usefixmap.vercel.app](https://usefixmap.vercel.app)

GitHub:
https://github.com/aryamthecodebreaker/FixMap

Please:

1. Explain FixMap to me in simple, practical language.
2. Give me a realistic example of when I would use it.
3. Explain how it differs from normal grep/search, BM25-style code retrieval, and an AI coding agent searching a repository by itself.
4. Explain what FixMap does NOT do.
5. Ask what coding tool or workflow I use, then tailor any follow-up explanation to that workflow.

Do not assume features that are not supported by the information above. If you are unsure about something, say so.
Runs on your computer No API key Free and open source
Want to see it once? Watch the 31-second video.
Try FixMap on a sample projectRuns in this tab
1. Tell FixMapWhat is broken?

Change the text or choose an example. Then press Run FixMap.

Sample project sample-api
fixmap plan --issue 'TOKEN_TTL_MINUTES is ignored, reset links expire immediately' --format agent
2. FixMap checks the sample project
3. FixMap showsWhere to start

File to check first
src/auth/reset-password.tsdefines task identifiers: TOKEN_TTL_MINUTES
Test to run
npm run testrepository root script named test · Nearest test: test/auth/reset-password.test.ts
Other code to review
src/http/routes.tschanged alongside src/auth/reset-password.ts in 2 of its 4 eligible changesArea to review: authentication · ranked files touch authentication; review this area before editing, but no diff evidence is available yet
This box uses a small sample project. It does not read your project, and nothing you type is uploaded.Use it on my project

FixMap makes a simple starting list.

It does not write the fix. It helps the AI tool know where to look first.

01Files to check first

See which files best match the problem and why FixMap picked them.

02Tests to run

See the closest tests and the commands that run them.

03Other code to review

See nearby code and sensitive areas that may need a careful look.

What we know. What we do not know yet.

We tested whether FixMap finds the right files. We have not proved that coding agents finish faster or use fewer tokens.

See every test case
Tested5/9 held-out tasks put the fixing file in the first 3 results.

A simpler BM25 search tied FixMap in the Top-3 test. At Top-5, BM25 found 9/9; FixMap found 5/9.

How it worksFixMap looks for clues in the project, then builds the list.

It uses file names, code words, imports, nearby tests, and a limited amount of Git history.

Not tested yetWhether FixMap saves time, tokens, money, or tool calls—or improves task success.

The study plan exists, but no completed runs support those claims yet.

Pick the easiest way to use FixMap.

Inside your AI coding tool

Type /fixmap in Claude Code, Cursor, GitHub Copilot, or another supported tool.

Set up

In your terminal

Run one command on your computer. No account or API key is needed.

Set up

On pull requests

Add a FixMap report whenever a pull request changes.

Set up

Watch one full example.

See a coding problem turn into a short list of files, tests, and related code.

Play the 31-second video
Want your AI coding tool to know where to start?Try the sample or use FixMap on your project.
Get started View source