footprint

footprint

Generate a per-repository report of a user's commits and squash-merged pull requests in a GitHub organization for a given month.

Installation

Grab a static binary from releases page and install it in your $PATH.

Or install it with Go:

go install github.com/alternateved/footprint@latest

Or build it from source:

git clone https://github.com/alternateved/footprint
cd footprint
make install

Authentication

footprint requires a GitHub personal access token with repo scope when accessing private repositories. It resolves one from the following sources, in order:

1. GH_TOKEN environment variable takes precedence.

export GH_TOKEN=ghp_xxxx

1. gh - if the GitHub CLI is installed and authenticated, footprint uses its token automatically.

Usage

footprint -u <USER> -o <ORG> [-y <YEAR>] [-m <MONTH>]