GIT-STANDUP(1)

📦
version 7.5.0 · 8 versions
, in ubuntu stonking

💖 GIT-STANDUP(1) — Git Extras 💖

okay bestie, sit DOWN, because this is the manual page for git-standup from Git Extras, and it's literally about to become your new fave. It's here to Recall the commit history. 🕵️♀️✨

🌈 SYNOPSIS 🌈

git-standup [-a author] [-w weekstart-weekend|-d days-ago] [-m depth]
[-D date format] [-L] [-f] [-B] [-n number of commits] [-F
gpg|authordate]
git-standup -h

🎀 DESCRIPTION 🎀

Recall what you did on the last working day 🔥 … or be nosy and find out what someone else did 👀. Both are valid. Both are iconic.

✨ OPTIONS ✨

  • -a author — who wrote the commits, bestie. If you pass "all" it means you're specifying "all authors". Defaults to $(git config user.name). so yes, it already knows who you are 💅
  • -m depth — how deep the recursive directory search goes. Defaults to 1.
  • -L — turns on inclusion of symbolic links in that recursive directory search. symlinks get to come to the party too 🦋
  • -d days-ago — where the commit history starts. Defaults to 1, which means "1 days ago".
  • -w weekstart-weekend — limits the search range to weekdays. If weekstart and/or weekend are missing, they default to Mon and Fri. And here's the cute part: if the current day is weekstart, commits made on weekend get included too. i.e. calling git standup -w - on a Monday will include commits made on the last Friday. Monday-you is still eating Friday's leftovers, periodt 🍓
  • -D relative — the date format shown in commit history. Defaults to "relative".
  • -h — display help message. simple. kind. ✨
  • -f — fetch the latest commits before showing commit history. fresh data, no stale vibes.
⚠️ okay so listen: the former version of git standup accepted <author> <since> <until> as options. That interface is deprecated now, and please avoid using it! don't do it. it's giving 2016. 💀
  • -B — display the commits in branch groups. organized queen behavior 👑
  • -n number-of-commits — limits the number of commits displayed per group. By default, the limitation is applied at the repository level. For example, if you have 3 repositories under the current directory, git standup ... -n 1 will show you 3 commits at most. But when -B is specific, the limitation is applied at the branch level. For instance, if each of your 3 repositories have 2 branches, git standup ... -B -n 1 will display 6 commits at most. math is mathing 📐
  • -F gpg|authordate — changes how the commits are formatted. Takes an argument, and can be specified multiple times.
    • -F gpg: Display if commit is GPG signed (G) or not (N).
    • -F authordate: Print the author date instead of the commit date.

⚙️ GIT CONFIGS ⚙️

You can configure an implicit -w weekstart-weekend, which gets superseded if -w or -d is given on the command line. heads up tho: the weekstart-weekend must be specified — they don't have any default values like the -w flag does. no autopilot here bestie 🫶

$ git config --global git-extras.standup.implicit-week "Mon-Fri"

🌸 EXAMPLES 🌸

This shows your commits since yesterday:

$ git standup

a26d1f9 - add profile hook (69 minutes ago) <spacewander>

This shows the author's commits since last week:

$ git standup -a spacewander -d 7

a26d1f9 - add profile hook (70 minutes ago) <spacewander>
4e19859 - fix getTotalSize return value error (6 days ago) <spacewander>
36da84e - fix rename over bound (7 days ago) <spacewander>
8e4182a - add watermark.png (7 days ago) <spacewander>
46fef1d - use tinyXML to configure (7 days ago) <spacewander>

If the current directory is not a git repo, git-standup will fetch data from all top-level git repos under it:

$ cd ..
$ git standup -a spacewander -d 7

someProject/
4e19859 - fix getTotalSize return value error (6 days ago) <spacewander>
36da84e - fix rename over bound (7 days ago) <spacewander>
8e4182a - add watermark.png (7 days ago) <spacewander>
46fef1d - use tinyXML to configure (7 days ago) <spacewander>

By specifying the -B option, git-standup will group the commits in branches:

$ git standup -B -a spacewander -d 7

git-summary-cleanup
f788c78 - git-summary: clean up other shellcheck warnings (23 hours ago) <spacewander>
3e8c3ab - git-summary: fix incorrect active days when commits range is given (23 hours ago) <spacewander>
ff991ac - git-summary: remove useless result function. (23 hours ago) <spacewander>
203f5b4 - git-summary: add --dedup-by-email to remove duplicate users (5 days ago) <spacewander>

master
203f5b4 - git-summary: add --dedup-by-email to remove duplicate users (5 days ago) <spacewander>
📌 Note that the same commit can be seen in different branches. yes it's the same commit. no it's not a glitch. it's just how branches work bestie 💜

👑 AUTHOR 👑

Originally from https://github.com/kamranahmedse/git-standup

🐛 REPORTING BUGS 🐛

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

🔗 SEE ALSO 🔗

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

and that's the whole page bestie — git-standup(1), straight out of Git Extras, dated May 2026 💖 go forth and recall some commit history, you absolute icon 🌟

📦 where this page comes from