git-standup(1) - Recall the commit history

1. git-standup(1)
2. Git Extras
3. git-standup(1)

## NAME

`git-standup` - 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 what someone else did.

## OPTIONS

-a author

The author of commits. Use "all" means specifying "all authors". Defaults to `$(git config user.name)`.

-m depth

The depth of recursive directory search. Defaults to 1.

-L

Enable the inclusion of symbolic links in recursive directory search.

-d days-ago

The start of commit history. Defaults to 1, means "1 days ago".

-w weekstart-weekend

Limit the search range to weekdays. If weekstart and/or weekend are missing they default to Mon and Fri. If the current day is weekstart, commits made on weekend will be included. I.e. calling `git standup -w -` on a Monday will include commits made on the last Friday.

-D relative

The date format displayed in commit history. Defaults to "relative".

-h

Display help message.

-f

Fetch the latest commits before showing commit history.

The former version of `git standup` accepted `<author> <since> <until>` as options. This interface is deprecated now, and please avoid to use it!

-B

Display the commits in branch groups.

-n number-of-commits

Limit the number of commits displayed per group. By default, the limitation is applied in 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. When `-B` is specific, the limitation is applied in 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.

-F gpg|authordate

Change how the commits are formatted. Takes an argument, 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 a implicit -w weekstart-weekend, which is superseded if -w or -d is given on the command line. Note that the weekstart-weekend must be specified, they don't have any default values as the `-w` flag has.

    $ 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 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.

## 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>

2. March 2026
3. git-standup(1)