teamstats

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 teamstats

Usage

Simply run the command:

teamstats

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/teamstats-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

Excluded Files & Directories

The tool always excludes these files/directories from statistics:

• node_modules/ - Node.js dependencies
• dist/ - Build output
• package-lock.json - npm lock file
• yarn.lock - Yarn lock file

Plus, any patterns defined in your project's .gitignore file are automatically excluded as well.

This ensures accurate developer statistics by ignoring build artifacts, lock files, and other ignored files defined in your project.

Options

Global Installation

npm install -g teamstats
teamstats

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/teamstats-{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.