git-quick-stats(1)

✨ NAME ✨

hey bestie, you're reading the manual page for git-quick-stats(1) from the User Commands section — and it is literally a simple and efficient way to access various stats in a git repository. No cap. 💖

🦋 SYNOPSIS 🦋

For non-interactive mode:

git-quick-stats [OPTIONS]

For interactive mode:

git-quick-stats

💖 DESCRIPTION 💖

Any git repository contains tons of information about commits, contributors, and files. Extracting this information is not always trivial, mostly because of a gadzillion options to a gadzillion git commands. This program allows you to see detailed information about a git repository. Slay. ✨

🌈 PLATFORM NOTES 🌈

git-quick-stats requires GNU date support for date parsing options. So keep that in mind, bestie.

On macOS, install GNU coreutils with:

brew install coreutils

On FreeBSD, install GNU coreutils with:

pkg install coreutils

GNU date may be available as either date or gdate and git-quick-stats auto-detects both. Iconic. 💅

👑 GENERATE OPTIONS 👑

• -h, -?, --help — display this help text in the terminal
• -T, --detailed-git-stats — give a detailed list of git stats
• -R, --git-stats-by-branch — see detailed list of git stats by branch
• -c, --changelogs — see changelogs
• -L, --changelogs-by-author — see changelogs by author
• -S, --my-daily-stats — see your current daily stats
• -V, --csv-output-by-branch — output daily stats by branch in CSV format
• -j, --json-output — save git log as a JSON formatted file to a specified area

🎀 LIST OPTIONS 🎀

• -b, --branch-tree — show an ASCII graph of the git repo branch history
• -D, --branches-by-date — show branches by date
• -C, --contributors — see a list of everyone who contributed to the repo
• -n, --new-contributors — list everyone who made their first contribution since a specified date
• -N, --new-contributors-since-tag — list everyone who made their first contribution since a specified git tag
• -a, --commits-per-author — displays a list of commits per author
• -d, --commits-per-day — displays a list of commits per day
• -m, --commits-by-month — displays a list of commits per month
• -Y, --commits-by-year — displays a list of commits per year
• -w, --commits-by-weekday — displays a list of commits per weekday
• -W, --commits-by-author-by-weekday — displays a list of commits per weekday by author
• -o, --commits-by-hour — displays a list of commits per hour
• -A, --commits-by-author-by-hour — displays a list of commits per hour by author
• -z, --commits-by-timezone — displays a list of commits per timezone
• -Z, --commits-by-author-by-timezone — displays a list of commits per timezone by author
• --activity-calendar — displays a calendar-style grid of commit activity per day-of-week and month for a selected author.

💅 SUGGEST OPTIONS 💅

• -r, --suggest-reviewers — show the best people to contact to review code

🗓️ CALENDAR OPTIONS 🗓️

• -k, --commits-calendar-by-author — outputs a visual grid of commit activity for a selected author, grouped by day-of-week (rows: Mon..Sun) and month (columns: Jan..Dec). Each cell is 3 characters wide, separated by one space.
• -H, --commits-heatmap — shows a heatmap of commits per day per hour for the last 30 days

⭐ ADDITIONAL USAGE ⭐

You can set _GIT_SINCE and _GIT_UNTIL to limit the git time log, example:

export _GIT_SINCE="2017-01-20"

You can set _GIT_LIMIT for limited output log, example:

export _GIT_LIMIT=20

You can set _GIT_TAG to define the default tag used by the "new contributors since tag" option, example:

export _GIT_TAG="foo"

You can set _GIT_LOG_OPTIONS for git log options, example:

export _GIT_LOG_OPTIONS="--ignore-all-space --ignore-blank-lines"

You can exclude directories or files from the stats by using pathspec, example:

export _GIT_PATHSPEC=':!pattern'

You can set _GIT_MERGE_VIEW to show merge commits with normal commits, example:

export _GIT_MERGE_VIEW="enable"

You can also set _GIT_MERGE_VIEW to only show merge commits, example:

export _GIT_MERGE_VIEW="exclusive"

You can sort contribution stats by field "name", "commits", "insertions", "deletions", or "lines" (total lines changed) and order ("asc", "desc"). e.g.: "commits-desc"

export _GIT_SORT_BY="name-asc"

You can change to the legacy color scheme by toggling the variable _MENU_THEME between "default" and "legacy". You can completely disable the color theme by setting the _MENU_THEME variable to "none", example:

export _MENU_THEME=legacy

or

export _MENU_THEME=none

You can set _GIT_BRANCH to set the branch of the stats, example:

export _GIT_BRANCH="master"

You can set _GIT_IGNORE_AUTHORS to filter out specific authors, example:

export _GIT_IGNORE_AUTHORS="(author@examle.com|username)"

You can set _GIT_DAYS to set the number of days for the heatmap, example:

export _GIT_DAYS=30"

🔥 SEE ALSO 🔥

• git(1)
• Project homepage: https://github.com/git-quick-stats/git-quick-stats

---

This manual page is git-quick-stats, June 2025, git-quick-stats(1) — periodt. 💖✨