0.1.1 • Public • Published


Calculates the change in blame between two commits, or the blame for the entire repository tree at a particular commit.


 git-guilt [options] [<since>] [<until>]
 git-guilt [options] [-a|--all] <commit-ish>


     -h, --help               output usage information
     -V, --version            output the version number
     -e, --email              display author emails instead of names
     -w, --ignore-whitespace  ignore whitespace only changes when attributing blame
     -X, --debug              output debug information
     -a, --at                 display the total blame for the entire repository tree at a particular commit
     -b, --batch-size <n>     specify the number of concurrent blame operations to run (minimum of 2, defaults to 4)
     -d, --dir <path>         force git-guilt to run in the specified directory rather than attempt to detect the repository root


  • Install Git, Node.js (tested against v0.10.3) and npm
  • Run npm install -g git-guilt. You may need sudo.
  • Run git-guilt HEAD~1 HEAD in any git repository to see the blame delta for the last commit.

post-commit hook

To see your blame delta after each commit, you can invoke git-guilt from a post-commit hook. Create an executable file at .git/hooks/post-commit and add the following:

git guilt HEAD~1 HEAD

Then you should see blame delta information after each commit, e.g.:

$ git commit -m "Flesh out"
Tim Pettersen        ++++++++++++++++++++++++++++++++++++++++++++++(79)
Rebecca Willett      ----
[master 35f9416] Flesh out
1 file changed, 82 insertions(+), 3 deletions(-)
rewrite (83%)


Find blame delta from the last commit:

$ git-guilt HEAD~1 HEAD

Tim Pettersen        ++++++++++++++++++++++++++++++++++++++++++++++(79)
Pierre-Etienne...    ---
Jason Hinch          -----------------

Find blame delta over the last three weeks:

$ git-guilt `git log --until="3 weeks ago" --format="%H" -n 1` HEAD

Bryan Turner         ++++++++++++++++++++++++++++++++++++++++++++(6526)
Adam Ahmed           ++++++++++++++++++++++++++++++++++++++++++++(1358)
Charles O'Farrell    +++++++++++++++++++++++++++++++++++++++++++++(282)
Pierre-Etienne...    +++++++++++++++++++++++++++++++++++++++++++++(281)
Jonathan Poh         +++++++++++++++++++++++++++++++++++++++++++++(173)
Jason Hinch          ++++++++++++++++++++++++++++++++++++++++++++++(97)
Michael Heemskerk    ++++++++++++++++++++++++++++++++++++++++++++++(90)
Brent Plump          +++++++++++++++++++++++++++
Xu-Heng Tjhin        +++++
Anna Buttfield       -
Antoine Busch        -
David Black          -
Jared Wyles          -   
Matthew Watson       ------------
Michael McGlynn      ------------
Dariusz Kordonski    ------------------
Seb Ruiz             ---------------------------
Conor MacNeill       --------------------------------------
Geoff Crain          -------------------------------------------
Michael Studman      ---------------------------------------------(-82)
Tim Pettersen        --------------------------------------------(-108)
John Van Der Loo     --------------------------------------------(-246)
Thomas Bright        --------------------------------------------(-324)

Find blame delta for a topic branch:

$ git guilt `git merge-base master my-topic-branch` my-topic-branch

Xu-Heng Tjhin        +++++++++++++++++++++++++++++++++++++++++++++(209)
Jason Hinch          -
Michael McGlynn      -
John Van Der Loo     --
Jonathan Poh         ------
Seb Ruiz             ----------
Adam Ahmed           ---------------------------------------------(-98)

Find blame for the entire repository tree on master:

$ git guilt -a HEAD

Tim Pettersen           456
Richard Howard          3




Package Sidebar


npm i git-guilt

Weekly Downloads






Last publish


  • tpettersen