Skip to main content

Documentation Index

Fetch the complete documentation index at: https://gx.mubbie.dev/llms.txt

Use this file to discover all available pages before exploring further.

gx who identifies the top contributors to your repo, file, or directory. The output format varies depending on whether you pass a file, directory, or nothing.

​
Usage

gx who [path] [flags]
Examples: 
gx who                          # Top contributors (commits)
gx who src/auth.go              # Who owns this file (blame)
gx who src/                     # Who owns this directory
gx who --since 6months          # Only last 6 months
gx who src/ --since 2024-01-01  # Directory, since date

​
Flags

FlagShortDefaultDescription
--number-n5Number of contributors to show
--sinceOnly consider contributions after this date (e.g., 6months, 2024-01-01, yesterday)
--no-limitfalseRemove file cap for directory analysis

​
Modes

​
Repo-level: gx who

When run with no arguments, shows contributors by commit count using git shortlog -sne HEAD: 
$ gx who

 #  Author          Commits  Email
 1  Sarah Chen          953  sarahchen@users.noreply.github.com
 2  James Wilson        138  james.w@example.com
 3  Alex Kim             45  alex.kim@example.com
 4  Maria Lopez          19  maria.l@example.com
 5  Pat Taylor           12  pat.t@example.com

​
File-level: gx who <file>

When given a file path, shows blame-based line ownership: 
$ gx who src/auth.go

 #  Author          Lines    %  Email                             Last Edit
 1  Sarah Chen        120  54%  sarahchen@users.noreply.github..  2 weeks ago
 2  James Wilson       68  31%  james.w@example.com               1 month ago
 3  Alex Kim           34  15%  alex.kim@example.com              3 months ago

​
Directory-level: gx who <dir>

When given a directory, runs concurrent blame across all files (8 workers, capped at 200 files by default): 
$ gx who src/

 #  Author          Lines    %  Files  Email                             
 1  Sarah Chen       1420  48%     12  sarahchen@users.noreply.github..
 2  James Wilson      830  28%      8  james.w@example.com
 3  Alex Kim          450  15%      6  alex.kim@example.com
 4  Maria Lopez       180   6%      3  maria.l@example.com
 5  Pat Taylor         90   3%      2  pat.t@example.com
Use --no-limit to remove the 200-file cap for large directories.

​
More Examples

Show the top 10 contributors: 
gx who -n 10
Analyze a specific directory with no file cap: 
gx who src/ --no-limit
  1. Repo mode (gx who): Runs git shortlog -sne HEAD to gather contributors on the current branch
  2. File mode (gx who <file>): Runs git blame and aggregates lines per author, computing percentages and last edit timestamps
  3. Directory mode (gx who <dir>): Runs git blame concurrently across files (8 workers, capped at 200 files unless --no-limit is set), then aggregates lines, percentages, and file counts per author
  4. Results are sorted by commit count (repo mode) or line count (file/directory mode) descending