GIT-GUILT(1)

📦
version 7.5.0 · 7 versions
, in ubuntu stonking

👑 NAME 👑

git-guilt — calculate change between two revisions

Like fr fr, that's it, that's the whole gig. It's Git Extras era, manual page GIT-GUILT(1), and we're about to find out who's been carrying the blame this whole time. 💅

✨ SYNOPSIS ✨

git guilt [<option>]
git guilt [<option>] <since> [<until>]

Two whole forms, bestie. Pick your fighter. 🥊

💖 DESCRIPTION 💖

Okay so first form (aka git guilt with no revisions): it shows the total blame count for files with unstaged changes. That's it. Just a lil vibe check on who's holding the bag right now.

Then second form: it calculates the change in blame between two revisions. And here's the cute part — if you don't pass <until>, it just defaults to HEAD. Iconic. No notes. 🫶

🎀 OPTIONS 🎀

  • -h — Output usage information. The classic. The little "help me help you."
  • -e, --email — Display author emails instead of names. For when you need to @ them directly. 📧
  • -w, --ignore-whitespace — Ignore whitespace only changes when attributing blame. So nobody gets dragged for a stray space. 🧚
  • -d, --debug — Output debug information. Chaos mode for the curious. 🔍

🌸 Examples 🌸

Find blame on unstaged modified files:

$ git guilt      (1)
spacewander                   ++++

(1) There is only one modified file and it is not staged. The four pluses means that the file has four lines, all contributed by spacewander. No cap, four lines = four +. ✨

Find blame delta between two commits:

$ git guilt HEAD~3 HEAD^
spacewander                   +++++++++++++++++++++++++++++++++++++++++++++(115)
Jesse Sipprell                -

Look at that (115) — spacewander really said "I'll take the whole thing" and Jesse Sipprell caught a -. 😭

Find blame delta over the last three weeks:

$ git guilt `git log --until="3 weeks ago" --format="%H" -n 1`
Paul Schreiber                +++++++++++++++++++++++++++++++++++++++++++++(349)
spacewander                   +++++++++++++++++++++++++++++++++++++++++++++(113)
Mark Eissler                  ++++++++++++++++++++++++++
CJ                            +++++
nickl-                        -
Jesse Sipprell                -
Evan Grim                     -
Ben Parnell                   -
hemanth.hm                    --

Since git 1.8.5, the above can also be written as:

$ git guilt @{3.weeks.ago}

Shorter, cuter, same energy. iykyk. 🦋

Find blame delta for a topic branch:

$ git guilt `git merge-base master git-guilt` git-guilt
spacewander                   +++++++++++++++++++++++++++++++++++++++++++++(112)

💌 AUTHOR 💌

Written by spacewander <spacewanderlzx@gmail.com>

🐛 REPORTING BUGS 🐛

<https://github.com/tj/git-extras/issues>

Go tell them. They wanna know. Be nice about it tho. 🙈

🦋 SEE ALSO 🦋

<https://github.com/tj/git-extras>

So yeah bestie, that's git-guilt(1) from Git Extras, dated May 2026 — go forth, check your blame, and stay the main character of your own repo. 💅✨🎀💖

📦 where this page comes from