map

Generates a repository map — a condensed view of the most important symbols (functions, classes, types) in the codebase.

Usage

infiniloom map [PATH] [OPTIONS]

Description

The map command scans a repository, extracts symbols using Tree-sitter, builds a dependency graph, and computes PageRank to rank symbol importance. The output provides a quick architectural overview within a token budget.

Options

-b, --budget <TOKENS>

Token budget for map output (default: 2000)

-o, --output <PATH>

Output file path (default: stdout)

-m, --model <MODEL>

Target model for token counting (default: claude)

-i, --include <PATTERN>

Include only files matching glob pattern (repeatable)

-e, --exclude <PATTERN>

Exclude files/directories matching pattern (repeatable)

--include-tests

Include test files in map

-v, --verbose

Show detailed progress

Examples

# Generate map to stdout
infiniloom map

# Save map to file
infiniloom map -o repo-map.txt

# Control map detail with budget
infiniloom map --budget 500

# Map a specific directory
infiniloom map ./src

How It Works

Scans repository respecting .gitignore
Extracts symbols using Tree-sitter parsers
Builds dependency graph between symbols
Computes PageRank to identify key components
Generates map within the specified token budget