How pdavis68/repomapper works
RepoMap turns selected repository files into a ranked, token-bounded code map, exposed through a CLI and an MCP server. Its central workflow discovers files, extracts definitions and references with Tree-sitter queries, ranks related files and symbols, then renders a map sized to the token budget. The MCP server also offers identifier search. The core engine excerpt shows caching, ranking, and rendering behavior; the README documents the broader analysis stages and language support, while unsampled server details are represented only where the shown excerpt supports them.
Main entry points: repomap_class.py RepoMap engine · repomap.py CLI entry point · repomap_server.py MCP server · scm.py Query lookup
Components 19
User Interfaces
- CLI entry point
repomap.py - MCP server
repomap_server.py - Map tool
repomap_server.py - Identifier search
repomap_server.py
Code Analysis
- File discovery
repomap.py - RepoMap engine
repomap_class.py - Tag extraction
repomap_class.py - Tag cache
repomap_class.py
Ranking and Output
- Reference graph
repomap_class.py - PageRank ranking
repomap_class.py - Important file rules
importance.py - Token-budget fitting
repomap_class.py - Map rendering
repomap_class.py
Parsing Support
- Token counting
utils.py - Text reading
utils.py - Query lookup
scm.py - Language queries
queries
Other components
- CLI user
- MCP client
Connections 21
- CLI user → CLI entry point: invokes
README.md - CLI entry point → File discovery: expands paths
repomap.py - CLI entry point → RepoMap engine: runs mapping
repomap.py - MCP client → MCP server: requests tools
README.md - MCP server → Map tool: registers tools
repomap_server.py - Map tool → File discovery: scans files
repomap_server.py - Map tool → RepoMap engine: runs mapping
repomap_server.py - MCP server → Identifier search: serves search
repomap_server.py - Identifier search → RepoMap engine: gets tags
repomap_server.py - Identifier search → Map rendering: renders context
repomap_server.py - RepoMap engine → Tag extraction: extracts tags
repomap_class.py - Tag extraction → Tag cache: reads writes
repomap_class.py - Tag extraction → Query lookup: selects queries
repomap_class.py - Query lookup → Language queries: locates query
scm.py - RepoMap engine → Reference graph: builds references
repomap_class.py - Reference graph → PageRank ranking: ranks graph
repomap_class.py - RepoMap engine → Important file rules: filters files
repomap_class.py - RepoMap engine → Token-budget fitting: fits map budget
repomap_class.py - Token-budget fitting → Map rendering: formats snippets
repomap_class.py - RepoMap engine → Token counting: counts tokens
repomap_class.py - RepoMap engine → Text reading: reads source
repomap_class.py