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

-m N, --max N
    Number of days back to look (default: 7)

-d DATE, --date DATE
    Start date in YYYY-MM-DD format (default: today)

-M EMAIL, --mailto EMAIL
    Author email to filter commits (default: current user)

-g DIR, --git-dir DIR
    Path to Git repository (default: .)

-L, --no-local
    Exclude the local repository from search

-f, --find-other-repo
    Find other repos in parent directories

-h, --help
    Show help message

-V, --version
    Print version information

DESCRIPTION

git-standup is a third-party command-line tool that generates a concise standup report by scanning Git repositories in the current directory and subdirectories. It displays recent commits authored by the current user (matched by email or name) over the past N days (default: 7), including commit messages, dates, repos, and branches.

Perfect for agile teams or solo developers needing a quick overview of their activity across projects without manual git log commands per repo. Output is formatted chronologically, grouped by date, making it easy to review what was accomplished recently.

It recursively finds .git directories, excluding local repo optionally, and supports custom date ranges or git dirs. Widely used in devops and software engineering workflows for daily standups, saving time on multi-repo setups.

CAVEATS

Third-party tool (not core Git); requires separate installation. Only matches author by email/user; may miss commits if config differs across repos. Performance slows with many/large repos. Node.js (npm) or Rust versions available—check compatibility.

INSTALLATION

npm install -g git-standup
or cargo install git-standup (Rust variant)

EXAMPLE USAGE

git-standup -m 5 (last 5 days)
git-standup -d 2023-10-01 (from specific date)

HISTORY

Created by Trevor Miller in 2015 as a Bash/JS script for multi-repo workflows. Gained popularity via GitHub (trevordmiller/git-standup, 5k+ stars). Ports to Rust (standup-rs) and others emerged. Commonly installed via npm in dev environments.

SEE ALSO

Copied to clipboard