repo-wrapped

A CLI tool for generating Git repository analytics and visualizations.

Installation

npm install -g repo-wrapped

Usage

Generate Visualization

# Current directory, current year
repo-wrapped generate

# Specific repository with HTML output
repo-wrapped generate /path/to/repo --html

# Analyze entire repository lifetime
repo-wrapped generate . --all --html

# Deep analysis with file-level knowledge distribution
repo-wrapped generate . --html --deep-analysis

Options

| Flag | Description | |------|-------------| | -y, --year <year> | Year to analyze (default: current year) | | -m, --months <months> | Number of months to show (1-12, default: 12) | | -a, --all | Analyze entire repository lifetime | | --html | Generate HTML report and open in browser | | --body-check | Include commit body in quality scoring | | --deep-analysis | Enable file-level analysis for knowledge distribution |

Year in Code Summary

repo-wrapped wrapped 2024 . --html

HTML Report Sections

• Contribution Graph - Interactive commit heatmap
• Streak Analytics - Current and longest streaks, active day percentage
• Time Patterns - Hourly/daily distribution, chronotype detection, burnout risk
• Commit Quality - Message quality scoring, conventional commits adherence
• File Hotspots - Most changed files, technical debt indicators
• Achievements - Progress-based badges and milestones
• Impact Analysis - Lines changed, churn metrics
• Knowledge Distribution - Bus factor risk, ownership analysis

Development

npm install
npm run build
npm link

Project Structure

src/
├── index.ts                 # CLI entry point
├── commands/
│   └── generate.ts          # Generate command
├── types/
│   └── index.ts             # TypeScript interfaces
├── generators/
│   └── html/
│       ├── scripts/         # Client-side JS
│       ├── styles/          # CSS files
│       ├── templates/       # HTML section builders
│       └── utils/           # Build utilities
└── utils/
    ├── gitParser.ts         # Git log parsing
    ├── htmlGenerator.ts     # HTML report assembly
    ├── streakCalculator.ts  # Streak analytics
    ├── timePatternAnalyzer.ts
    ├── commitQualityAnalyzer.ts
    ├── fileHotspotAnalyzer.ts
    ├── achievementEngine.ts
    ├── impactAnalyzer.ts
    └── knowledgeDistributionAnalyzer.ts

License

MIT