Package Exports

teamstats
teamstats/dist/cli.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (teamstats) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

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

Select branch (default: current branch)
- Press Enter to use current branch
- Or enter a different branch name
Start date (default: 1st of current month)
- Format: YYYY-MM-DD
- Press Enter to use default
End date (default: last day of current month)
- Format: YYYY-MM-DD
- Press Enter to use default
Authors (default: all committers)
- Space-separated email addresses
- Example: john@example.com jane@example.com
- Press Enter to include all authors
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
─────────────────────────────────────────────────────────────
john.doe@company.com           |       2450 |       1230 |         15
jane.smith@company.com         |       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 salih.kesepara@logiwa.com

Support

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