Complex

A code repository complexity analyzer CLI tool that analyzes git repositories and generates comprehensive reports with complexity scores and team size estimates.

Features

• Multi-Language Support - Analyzes C#/.NET, TypeScript/Angular, Python, and C++ projects
• Multi-Repository Analysis - Analyze multiple repositories in a single run with comma-separated URLs
• Complexity Scoring - Scores based on lines of code, file count, technology stack, and file type diversity
• Team Size Estimation - Estimates recommended team size per project and across repositories
• Comprehensive Reports - Generates detailed Markdown reports with per-project breakdowns
• Plugin Architecture - Extensible language support through analyzer plugins

Installation

As a .NET Global Tool (Recommended)

dotnet tool install -g Complex.Cli

As a .NET Local Tool

dotnet new tool-manifest # if you don't have one already
dotnet tool install Complex.Cli

Build from Source

git clone https://github.com/QuinntyneBrown/Complex.git
cd Complex
dotnet build

Quick Start

Analyze a Single Repository

complex analyze --url https://github.com/dotnet/aspnetcore

Analyze Multiple Repositories

Pass a comma-separated list of URLs to analyze several repositories in one run:

complex analyze --url "https://github.com/dotnet/aspnetcore,https://github.com/angular/angular,https://github.com/pallets/flask"

Custom Output Path

complex analyze --url https://github.com/dotnet/aspnetcore --output reports/aspnetcore-analysis.md

Help

complex --help
complex analyze --help

CLI Reference

complex analyze [options]

Options:
  -u, --url <url>       URL of the git repository to analyze.
                         Supports comma-separated URLs for multi-repo analysis.
                         (Required)
  -o, --output <path>   Output path for the analysis report.
                         (Default: ./analysis-report.md)
  -?, --help            Show help and usage information