Repo Map

Extracts function, class, module definitions and reference calls from source code using Tree-sitter parsers with language-specific query files (@definition.function, @definition.class, @reference.call). The system maintains a Tag namedtuple structure (rel_fname, fname, line, name, kind) that captures extracted code entities with their locations and types. This enables structurally-aware parsing across 40+ languages without regex-based heuristics, producing precise AST-based extraction that preserves semantic relationships.

Analyzes code dependency graphs using PageRank algorithm to rank files and functions by importance, identifying which components are most central to understanding the repository. The system builds a directed graph from function calls and class references extracted by Tree-sitter, then applies iterative PageRank computation to assign importance scores. This graph-based approach recognizes that frequently-called functions and heavily-referenced classes are more important for LLM context than isolated utility functions.

Intelligently selects and formats code content to fit within LLM context windows using binary search over token counts. The try_tags() function performs binary search on ranked code entities, progressively including more code while monitoring token consumption via tiktoken or equivalent tokenizer. This ensures the output respects token limits while maximizing the amount of relevant code included, formatting results with function prototypes and file relationships in order of PageRank importance.

Caches extracted code tags and PageRank computations to disk using diskcache library, with automatic invalidation based on file modification times. The load_tags_cache() and save_tags_cache() methods manage persistent storage, checking file mtimes to determine cache validity. This avoids re-parsing and re-ranking unchanged files across multiple invocations, significantly accelerating repeated analyses of the same codebase while ensuring cache freshness when files change.

Provides a CLI tool that accepts repository paths and optional configuration parameters, generating formatted repo maps for immediate use or piping to other tools. The CLI interface wraps the RepoMap class, exposing methods like get_repo_map() with configurable token limits, file filters, and output formats. This enables developers to quickly analyze any codebase from the terminal, integrate RepoMapper into shell scripts, or use it as a preprocessing step for other tools.

Implements an MCP server that exposes RepoMapper functionality as callable tools for LLM-powered applications and agents. The MCP server wraps RepoMap methods as MCP tools with standardized schemas, enabling seamless integration with Claude, other LLMs, and MCP-compatible applications. This allows LLMs to request repo maps on-demand during conversations, with automatic caching and incremental updates, without requiring the LLM to understand RepoMapper's internal architecture.

Supports code extraction across 40+ programming languages through Tree-sitter grammar integration, with a pluggable architecture for adding new languages. The system maintains language-specific query files that define how to extract definitions and references for each language, allowing consistent extraction semantics across Python, JavaScript, TypeScript, Go, Rust, Java, C++, and others. New language support can be added by defining query files without modifying core extraction logic.

Allows users to specify which files should be included or excluded from repo map generation through configurable filtering rules. The system supports patterns for ignoring common non-essential files (node_modules, .git, __pycache__, etc.) and prioritizing important files (main entry points, configuration files). This enables focused analysis of relevant code while reducing noise from dependencies and generated files, with rules that can be customized per repository.

Generates human-readable repo maps that include function/class prototypes, file relationships, and importance rankings in a structured text format. The get_repo_map() method formats extracted code entities with their signatures, line numbers, and relationships to other code, organized by importance. This output is designed to be comprehensible to both humans and LLMs, providing enough context to understand code structure without overwhelming with full source code.