dsh-repo-map

Working with AI inside a large codebase, the bottleneck is rarely model intelligence—it is context budget. dsh-repo-map takes a deliberately minimal approach: instead of dumping entire source files into the prompt, it builds a read-only structural and symbol index so the model can survey the project skeleton before diving in. It is designed as a complement to dsh-context-pack; where that plugin handles context injection, dsh-repo-map handles navigation at the structure-and-symbol level, keeping token overlap to a minimum.

Two capabilities do the heavy lifting in v0.1. First, it recognizes common source declarations—functions, classes, variables—and distills them into a symbol map that reflects the shape of your code. Second, it automatically skips generated code and vendor directories, so the index mirrors what you actually wrote rather than what a build system produced. The plugin is lightweight and strictly read-only: it never modifies files and has no write side-effects.

If you frequently need AI assistance in a mid-to-large repository and do not want to burn tokens on third-party dependencies or build artifacts, dsh-repo-map is a low-cost first step: hand the model a map, then let it choose which street to walk down.