repo-compass

Name: repo-compass
Author: pietrotommasini2022

by pietrotommasini2022

Warning

Static code intelligence for AI-assisted development. Generates a dense CODEBASE.ctx from your source files — no API calls, pure local compute.

0stars

0forks

TypeScript

Installation

# Add to your Claude Code skills
git clone https://github.com/pietrotommasini2022/repo-compass

Getting Started

Guides for using api integration skills like repo-compass.

Getting Started with AI Skills
First-time install walkthrough for Claude Code, Codex CLI, and ChatGPT.
What is an AI Skills Marketplace?
Definitions, how marketplaces work, and how to choose between them in 2026.

Security ReportWarning

Last scanned: 5/30/2026

{
  "issues": [
    {
      "type": "npm-audit",
      "message": "brace-expansion: brace-expansion: Large numeric range defeats documented `max` DoS protection",
      "severity": "medium"
    },
    {
      "type": "npm-audit",
      "message": "diff: jsdiff has a Denial of Service vulnerability in parsePatch and applyPatch",
      "severity": "low"
    },
    {
      "type": "npm-audit",
      "message": "js-yaml: js-yaml has prototype pollution in merge (<<)",
      "severity": "medium"
    },
    {
      "type": "npm-audit",
      "message": "minimatch: minimatch has a ReDoS via repeated wildcards with non-matching literal in pattern",
      "severity": "high"
    },
    {
      "type": "npm-audit",
      "message": "mocha: Vulnerability found",
      "severity": "high"
    },
    {
      "type": "npm-audit",
      "message": "nanoid: Predictable results in nanoid generation when given non-integer values",
      "severity": "medium"
    },
    {
      "type": "npm-audit",
      "message": "serialize-javascript: Serialize JavaScript is Vulnerable to RCE via RegExp.flags and Date.prototype.toISOString()",
      "severity": "high"
    }
  ],
  "status": "WARNING",
  "scannedAt": "2026-05-30T17:06:34.327Z",
  "npmAuditRan": true,
  "pipAuditRan": true
}

README.md

Frequently Asked Questions

What is repo-compass?

repo-compass is an open-source api integration skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by pietrotommasini2022. Static code intelligence for AI-assisted development. Generates a dense CODEBASE.ctx from your source files — no API calls, pure local compute. It has 0 GitHub stars.

Is repo-compass safe to use?

repo-compass returned warnings in SkillsLLM's automated security scan. It has no critical vulnerabilities, but review the flagged issues in the Security Report section before adding it to your workflow.

How do I install repo-compass?

Clone the repository with "git clone https://github.com/pietrotommasini2022/repo-compass" and add it to your Claude Code skills directory (see the Installation section above).

What programming language is repo-compass written in?

repo-compass is primarily written in TypeScript. It is open-source under pietrotommasini2022 on GitHub, so you can review or fork the full source.

Are there alternatives to repo-compass?

Yes. SkillsLLM lists many other API Integration skills you can browse and compare side by side. Open the API Integration category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh repo-compass against similar tools.

LLM Engineer for Beginners

Ship LLM features to production - prompts, RAG, structured outputs, evaluation

39 minBeginner

Comments (0)

to leave a comment.

No comments yet. Be the first to share your thoughts!

Related Skills

ECC

by affaan-m

The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.

216,382

Popular in API Integration

Top skills in this category by stars

sub2api

by Wei-Shaw

Sub2API is an open-source relay platform that unifies Claude, OpenAI, Gemini, and Antigravity subscriptions into a single endpoint. It supports account sharing and cost-sharing, with seamless native tool compatibility.

27,986

investor-recon

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.

Manual install: if you installed via a local clone or need to reinstall the skill, run node scripts/postinstall.cjs from the package root, or copy .claude/commands/repo-compass.md to ~/.claude/commands/.

What it analyzes

Languages: TypeScript, JavaScript (ESM + CJS), Python

Extracts:

Functions with signatures and return types
Classes, interfaces, type aliases, enums
Re-exports and default exports
CJS module.exports patterns
Python functions, classes, constants, __all__

Graph:

Resolves relative imports to actual file paths (handles .js → .ts NodeNext convention)
Counts how many files import each module (★ = imported by 2+)
Core modules get full detail; leaf modules get summary-only

Project detection:

Monorepos: pnpm-workspace.yaml, package.json workspaces
Source roots: src/, lib/, app/, pages/, and more
Python flat layout: directories with __init__.py
Project type: cli | library | app | unknown

Large repos

Above 300 files, CODEBASE.ctx switches to compact mode: only core modules (★) get full import/export detail. Leaf files appear as a single line. This keeps the file readable and useful even on large codebases.

You'll be prompted before scanning large repos. Use --all to skip.

Token efficiency

A typical 50-file project generates a CODEBASE.ctx of ~1000 tokens. Reading individual source files for the same coverage would cost 20–50×. At 300 files, compact mode keeps output under 6000 tokens while preserving full fidelity for the modules that matter.

License

MIT