commitviz-cli

Beautiful git commit activity visualizer for the terminal. GitHub-style heatmaps, contributor stats, file churn analysis, word clouds, and more.

Install

npm install -g commitviz-cli

Usage

Run inside any git repository:

# GitHub-style contribution heatmap
commitviz heatmap

# Commit frequency by hour and day of week
commitviz activity

# Top contributors table
commitviz authors

# File churn analysis (most changed files)
commitviz churn

# Commit message word cloud
commitviz words

# Branch comparison stats
commitviz compare main..feature

Options

| Option | Description | |--------|-------------| | --since <date> | Filter commits from date (e.g. 2026-01-01) | | --until <date> | Filter commits until date | | --json | Output results as JSON | | -n, --limit <n> | Limit results (churn, words) |

Examples

# Heatmap for 2026
commitviz heatmap --since 2026-01-01

# Top 10 most changed files as JSON
commitviz churn -n 10 --json

# Activity for last month
commitviz activity --since 2026-02-01

# Compare branches
commitviz compare main..develop

Features

• Heatmap: GitHub-style contribution graph with color intensity
• Activity: Hour-of-day and day-of-week commit distribution with bar charts
• Authors: Ranked contributor table with insertions/deletions/files stats
• Churn: Most frequently changed files ranked by total changes
• Words: Most common words in commit messages
• Compare: Side-by-side branch comparison statistics

Requirements

• Node.js >= 14
• Git installed and accessible via PATH
• Must be run inside a git repository

License

MIT