code-report

Interactive developer statistics report generator - analyze git commits and code changes with Excel export.

Features

• 📊 Interactive CLI - Easy-to-use prompts for all parameters
• 📈 Git Statistics - Analyzes commits, lines added/deleted per author
• 📅 Date Range - Flexible date selection with sensible defaults
• 📁 Branch Support - Works with any git branch
• 🎯 Author Filtering - View stats for specific authors or all committers
• 📋 Excel Export - Professional Excel reports with formatting
• ⚡ Fast - Leverages native git commands for performance

Installation

npm install -g code-report

Usage

Simply run the command:

code-report

Interactive Prompts

1. Select branch (default: current branch)

   • Press Enter to use current branch
   • Or enter a different branch name

2. Start date (default: 1st of current month)

   • Format: YYYY-MM-DD
   • Press Enter to use default

3. End date (default: last day of current month)

   • Format: YYYY-MM-DD
   • Press Enter to use default

4. Authors (default: all committers)

   • Space-separated email addresses
   • Example: [email protected] [email protected]
   • Press Enter to include all authors

5. Save as Excel? (default: yes)

   • Type yes or y to save
   • File saves to ~/Downloads/

Example Output

╔════════════════════════════════════════════════╗
║   Dev Statistics Report Generator              ║
╚════════════════════════════════════════════════╝

Select branch (default: dev):
Start date YYYY-MM-DD (default: 2026-02-01):
End date YYYY-MM-DD (default: 2026-02-28):
Authors - space-separated emails (leave empty for all):

Git Statistics Report
Branch: dev | Period: 2026-02-01 to 2026-02-28
─────────────────────────────────────────────────────────────
Author                         |      Added |    Deleted |    Commits
─────────────────────────────────────────────────────────────
[email protected]           |       2450 |       1230 |         15
[email protected]         |       1890 |        950 |         12
─────────────────────────────────────────────────────────────

Save as Excel file? (yes/no) (default: yes):

✓ Report saved to: /Users/username/Downloads/code-report-dev-2026-02-01_to_2026-02-28.xlsx

Excel Report Features

• 📑 Title and period information
• 🎨 Color-coded header (blue background, white text)
• 📌 Frozen header row for easy scrolling
• 📏 Auto-sized columns
• 🔲 Professional borders and alignment
• 📊 Right-aligned numbers for better readability

Requirements

• Node.js 18+
• Git installed and available in PATH

Which files are counted?

code-report counts only files that are committed to the repository and not covered by the project's current .gitignore (plus .git/info/exclude and your global git ignore).

• Untracked files are never counted — git log only sees committed history.
• Files added to .gitignore after they were committed are still filtered out, including their past commits.
• There is no hardcoded exclusion list. The project's .gitignore is the single source of truth.

Options

Global Installation

npm install -g code-report
code-report

Local Development

npm install
npm run build
npm start

Development Mode (with TypeScript)

npm install
npm run dev

Output

• Console output: Formatted table with all statistics
• Excel file: Saved to ~/Downloads/code-report-{branch}-{startDate}_to_{endDate}.xlsx

License

MIT

Author

Salih Kesepara [email protected]

Support

For issues or feature requests, please open an issue on the repository.