activity

See one combined commit activity calendar for your repositories.

Usagegit-wrangler activity [options]

Quick start

git-wrangler activity

What it does

activity combines commit dates from the repositories in your workspace into a GitHub-style calendar. It reads local history and does not contact remotes.

By default, it uses each repository’s main branch and gh-pages when available. A commit that appears through more than one branch is counted once.

Options

Option Default What it does
--repo <path> Whole workspace Show activity for exactly one repository.
--year YYYY All years Show one year.
--user <name-or-email> All authors Include one exact author name or email. Repeat for more authors.
--all Off Include every normal branch and tag, not only the main branches.
--global-scale Off Use the same activity intensity scale for every displayed year.
--guided Off Choose options through prompts.

More examples

# Show one year for two author identities
git-wrangler activity --year 2026 \
  --user "Jane Doe" \
  --user jane@example.com

# Include all branches and tags
git-wrangler activity --all --global-scale

# Show one repository
git-wrangler activity --repo ./api

Dates are grouped in UTC. An empty result is successful and an explicitly requested empty year still displays a calendar.

  • Use log to see the commits behind the activity.
  • Use info for a detailed repository inventory.