Code Map

Your project drawn as a map.

The Code Map draws the project as rooms, blocks and files, with the calls between them. Open it with the Code Map button in the sidebar, or type /code-map in the agent's prompt box.

Walkthroughs

Ask the agent to show you how something works: "show me how a request is billed". The thread gets a card with Back and Next, and the Code Map flies to each step in turn, so you see where each part sits and not only what it does.

  • Each step is a file, and a symbol in it, with a sentence on what happens there.
  • If the Code Map isn't open, the card has an Open map button. Back and Next never open it.
  • A walkthrough works before the map is finished, and it isn't saved in the map.

The Mapping Agent

The map is built by the Mapping Agent, a background agent thread.

  • It starts on its own when you open a trusted folder that has no map.
  • After you change code, it updates the parts of the map that changed.
  • Its runs use your Sansa usage.
  • The Mapping Agent button in the status bar shows its runs and stops one.

To stop it from running, set "graph.map_thread": false. The map you have stays, and agents can still edit it.

Where it's stored

.ngram/code-map/
  map.json
  blocks/<id>.json
  notes/<id>.md

The map is meant to be committed, so your team shares one. To keep it out of git, add .ngram/code-map/ to .gitignore. Every clone then builds its own.