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>.mdThe 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.