GIT-EFFORT(1)

📦
version 7.5.0 · 7 versions
, in ubuntu stonking

💖 GIT-EFFORT(1) — Git Extras 💖

okay bestie, sit down, hydrate, because we're about to talk about git-effort. it's the little Git Extras baddie that tells you which of your files are doing the most work. main character stats, no cap.

✨ NAME ✨

git-effort — show effort statistics on file(s) 🦋

🌸 SYNOPSIS 🌸

git-effort [--above <value>] [<path>...] [-- [<log options>...]]

💅 DESCRIPTION 💅

it shows effort statistics about the files in your repository. like, who's actually pulling their weight in this repo? the drama. the reveals.

the display includes these two icons:

  • Commits — the number of commits per file. it highlights the files with the most activity, so you can see who's been eating. 👑
  • Active days — the total number of days that contributed modifications to this file. so if a file got touched on 18 different days, that's 18, bestie. consistency! 💖

🎀 OPTIONS 🎀

  • --above <value> — ignore files with commits <= a value. so if you only care about the mains and not the extras, set a floor and vibe. 🙈
  • <path>... — only count commits that touch the given paths. keep it scoped, keep it cute.
heads up: git-effort does not accept revision ranges, but the underlying git log does (check the examples! 👀).
  • <log options>... — options for git log. and listen, you must use -- to separate the options going to git log from the options going to git effort. that little separator is what makes it possible to only count commits you're actually interested in. not every option is relevant in the context of git-effort, but the ones that are relevant are listed under the "Commit Limiting" section on the git-log manpages. so go read that if you want the deep lore. 📚

🔥 EXAMPLES 🔥

note: output will first appear unsorted, then the screen gets cleared and the sorted list is output. the initial unsorted list is not shown in the examples, for brevity. it's giving chaos then clarity, honestly.

displays "effort" statistics:

$ git effort --above 5

  file                                          commits    active days

  git-extras                                    26         18
  git-release                                   13         13
  git-effort                                    13         2
  git-ignore                                    11         7
  git-changelog                                 11         8
  git-graft                                     9          6
  git-summary                                   8          6
  git-delete-branch                             8          6
  git-repl                                      7          5

$ git effort --above 5 bin/* -- --after="one year ago" --author="Leila Muhtasib"

  file                                          commits    active days

  git-extras                                    15         12
  git-release                                   6          4
  git-effort                                    6          2
  git-ignore                                    4          4
  git-changelog                                 3          2
  git-graft                                     2          2

showing statistics on directories is also possible, which is lowkey the most useful thing ever:

$ git effort bin man -- --after="one year ago"

  file                                          commits    active days

  bin.......................................... 406        232
  man.......................................... 118        80

only count commits in the specified revision range:

$ git effort -- master..feature

  file                                          commits    active days

  bin/git-effort............................... 3          2
  man/git-effort.md............................ 1          1

👑 AUTHOR 👑

Written by Leila Muhtasib <muhtasib@gmail.com> — icon behavior, honestly. 💜

😭 REPORTING BUGS 😭

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

if something's broken, tell them there. we don't gatekeep bugs in this house.

🌈 SEE ALSO 🌈

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

and that's the whole page, bestie!! no cap, you're now officially certified in git-effort 🧚✨ this was brought to you by the Git Extras girlies, from the May 2026 edition of the GIT-EFFORT(1) manual page. periodt. 💅🫶

📦 where this page comes from