About this project

RepoScout is a high-performance command-line tool written in Rust designed to scan Git repositories (or specific paths) and deliver consolidated code intelligence. It targets two primary audiences: AI coding agents that require stable, machine-readable JSON outputs to understand codebases quickly, and human developers who need compact, colored terminal summaries or Markdown reports for PRs and issues. The tool aggregates various signals to answer key questions about a repository: - **Inventory**: Identifies languages, files, lines of code, tokens, symbols, and imports. - **Risk Assessment**: Calculates per-callable complexity, maintainability, churn, and test presence, ranking them by composite risk. - **Duplication Detection**: Finds exact and Type-2 (consistent-rename) duplication, helping determine if cleanup is worthwhile. - **Context Planning**: Generates deterministic reading plans under strict token and file budgets to optimize agent context windows. - **Change Intelligence**: Analyzes Git diffs, tracks changed lines, assesses impact, and exports findings in SARIF, DOT, or Mermaid formats. RepoScout operates entirely locally, ensuring source code privacy by not uploading data or calling external models. It supports first-class AST analysis for Rust, Python, JavaScript, TypeScript, Go, PHP, and Godot languages, with additional syntax-aware inventory for 36 other formats. Features include an optional live local dashboard with a React interface for visualizing repository health and architecture graphs. The tool provides guardrailed execution profiles for scanning untrusted checkouts and supports agent skill integration via `skills.sh`.