Active

Repo Inspector

A CLI tool that uses AI to analyze codebases and explain what they do, how they're structured, and how data flows through them.

Python Google Gemini API
View Source

Overview

Repo Inspector automatically examines source code repositories and generates comprehensive documentation explaining the project’s purpose, technical architecture, key directories, entry points, and data flow patterns.

Features

  • Dual explanation levels: Beginner mode for onboarding and senior mode for technical reviews
  • Multiple output formats: Text or Markdown documentation
  • Architecture visualization: Optional Mermaid diagrams
  • Intelligent code scanning: Automatically excludes build artifacts, dependencies, and version control files
  • Context-aware chunking: Processes large codebases by intelligently breaking code into analyzable pieces

Supported Languages

JavaScript, TypeScript, Python, Go, Java, Rust, C++, Swift, Kotlin, and configuration formats (YAML, JSON, TOML).

Installation

pip install repo-inspector

Usage

# Analyze a repository with beginner-friendly explanations
repo-inspector /path/to/repo --level beginner

# Generate senior-level technical documentation
repo-inspector /path/to/repo --level senior

# Output as Markdown with architecture diagram
repo-inspector /path/to/repo --format markdown --diagram
← Back to Projects