LinuxCommandLibrary

git-standup

Generate stand-up reports from git history

TLDR

Show a given author's commits from the last 10 days

$ git standup -a [name|email] -d [10]
copy

Show a given author's commits from the last 10 days and whether they are GPG signed
$ git standup -a [name|email] -d [10] -g
copy

Show all the commits from all contributors for the last 10 days
$ git standup -a all -d [10]
copy

Display help
$ git standup -h
copy

SYNOPSIS

git standup [options]

PARAMETERS

--version
    Display the version number.

--after=
    Show commits after specified date, useful for weekly standups. ex: git standup --after="last monday"

--before=
    Show commits before specified date. This might be useful with --after parameter.

--repos=
    Specify the project root. Default is current directory.

--format=
    Specify the output format. Available formats are 'pretty' (default), 'json', and 'csv'.

--day=
    Show commits only for specified date. ex: git standup --day=2024-01-01

--all
    Include commits from all branches.

--debug
    Enable debug output.

--help
    Display help information.

DESCRIPTION

git-standup is a command-line tool designed to help you quickly review your Git activity for a specific time period, typically used for preparing for daily stand-up meetings.
It aggregates your commits across all local Git repositories (that are subdirectories of your chosen project root), grouping them by branch and displaying the commit messages.

This tool is extremely useful when you have a large number of Git repositories, are contributing on many features, or if you need to present the history of your contributions.

CAVEATS

Requires that all your Git repositories are subdirectories of a common project root. It relies on being able to execute `git` commands within each of those repositories.
It doesn't track remote branches without a corresponding local branch configured.

CONFIGURATION

While not explicitly configurable through a configuration file, its behavior is driven by the command-line options. The `--repos` parameter is the closest thing to configuration, allowing you to specify the root directory to search for Git repositories.

HISTORY

git-standup appears to be a community-developed tool that has gained popularity for its ability to streamline the stand-up preparation process. Development focused on automating commit summary across multiple repos.
It is available as a package via NPM and other package managers.

SEE ALSO

git log(1), git branch(1), find(1)

Copied to clipboard