A fast, zero-dependency CLI tool to analyze local Git commits, track productivity streaks, and render contribution heatmaps directly in your terminal
- Multi-Repository Discovery: Automatically scans target directories and subfolders for local
.gitrepositories. - Terminal Heatmap Grid: Renders a full 52-week contribution matrix matching exact day-of-week alignment.
- Theme System: Seamlessly switch color palettes (
github,cyberpunk,monokai). - Productivity Analytics:
- Total annual commit count.
- Active daily streaks (current and longest).
- Peak productivity hour detection (Peak Hour Analysis).
- Zero External Runtime Heavyweights: Pure Node.js and standard Git binary integration.
Install the package globally on your system via npm:
npm install -g .Or link it locally for active development:
npm linkOnce installed, the gmatrix command becomes available globally in your terminal.
Run directly inside any Git repository to scan its local history:
gmatrixPass a path to scan all subdirectories for .git repositories (for example, your entire home directory or projects folder):
gmatrix --path ~/Customize output using flags:
| Option | Description | Default |
|---|---|---|
--path <path> |
Root directory path to search for Git repositories | Current working directory |
--year <year> |
Target calendar year for analysis | Current year |
--theme <name> |
Visual color scheme (github, cyberpunk, monokai) |
github |
--help |
Print CLI documentation and exit | false |
Run with Cyberpunk color theme:
gmatrix --theme cyberpunkAnalyze all local repositories in a custom directory for year 2025:
gmatrix --path ~/Projects --year 2025 --theme monokaiThis project was built step-by-step using modular architecture practices. You can review the commit history and inspect feature-by-feature evolution using standard Git commands:
# View concise commit history log
git log --oneline --graph
# Inspect changes in a specific commit
git show <commit-hash>Distributed under the MIT License. See LICENSE for more details.