repo-compass

Static code intelligence for AI-assisted development. Run one command, get a dense CODEBASE.ctx file that tells an AI everything it needs to know about your codebase — in under 2000 tokens.

What it does

repo-compass scan walks your source files, extracts exports, resolves imports, builds a module dependency graph, and writes CODEBASE.ctx to the repo root. No API calls. No AI. Pure local compute.

src/commands/scan.ts [★3] :: scanCommand:variable
> src/analyzers/entrypoints.ts,src/analyzers/source-files.ts,src/analyzers/graph-builder.ts

src/analyzers/file-analyzer.ts [★4] :: analyzeFile(root:string,relativePath:string):FileAnalysis
> src/types.ts

src/types.ts [★6] :: ExportItem:type | ResolvedImport:type | FileAnalysis:type | ModuleGraph:type | normalizePath(p:string):string

An AI reading this file understands your entire codebase structure — what each module exports, which modules are central (★), and how data flows between them — in a single read.

Install

npm install -g repo-compass

Usage

cd your-project
repo-compass scan

Generates CODEBASE.ctx in the current directory. Open it, paste it to any AI, or use the Claude Code skill (see below).

Options

--all    Skip confirmation prompt for large repos (>300 files)

Claude Code skill

The /repo-compass slash command is installed automatically when you install the package globally. No extra setup needed.

In any Claude Code session:

/repo-compass

Claude runs the CLI, reads CODEBASE.ctx, and instantly has full codebase context — without reading individual files or consuming thousands of tokens.