Compare GitHub contributions with a friend
Open both GitHub profiles and compare the contribution graphs for the same period, use a third-party stats board to put you and your friends on one leaderboard, or run a weekly head-to-head race that scores both of you from the same contribution calendar. Pick the one that fits how often you want to compete.
Comparing contributions with a friend sounds simple until you try it. Two green graphs side by side tell you who looked busy last year, but not who is ahead this week. I built Git Racer because I wanted the second one, so here are the three ways I know to do it and when each one fits.
Option 1: read the two profiles side by side
This is free and needs no tools. Open both profiles, pick the same year in the graph, and look at the totals and the shape of the squares. GitHub shows a contribution count for the selected period at the top of the graph.
It works for a quick look, but it has limits:
- You compare a year at a time, so a good week hides inside a quiet year.
- The graph counts more than commits. Issues, pull requests and reviews can count too, and the rules have gaps. I wrote them up in how GitHub counts contributions, which is worth reading before you argue about a total.
- Private contributions only show up as a number if that person chose to show them.
- Nobody wins anything. There is no finish line.
Option 2: use a stats board
A few third-party tools put you and your friends on one leaderboard. GitStats Board is one example. According to its AlternativeTo page, you sign in with GitHub, share an invite code to form a crew, and compare commits, lines added and deleted, active repos and streaks by week, month or year. It also has a small CLI that counts private repos locally and uploads only the numbers. The same page says it doesn't ask for GitHub's repo scope.
Other tools take a lighter route. Gitviz describes itself as a way to visually compare GitHub users' contributions. I haven't tested these tools myself, so check each one's permissions and privacy before you connect an account.
A stats board suits a group that wants a running scoreboard and cares about details like lines of code. The catch is that more metrics means more to argue about, and lines added is easy to inflate.
Option 3: race each other for a week
This is the one I built. A Git Racer race pits you against a friend (or a team of up to 50) over one ISO week, Monday to Sunday UTC. It resets every Monday, so a bad week is never permanent.
Think of it like a lap timer. You don't care who was faster last season, you care who is ahead right now.
Here is how it works:
- Sign in with GitHub. It asks only for the
read:userscope, so it has no access to your repos. - Pick your friend's GitHub username and start a race.
- Send them the race link. The page has a live leaderboard and a day-by-day table that shows who took each finished day.
- Check back through the week. Counts refresh on demand when they are 15 minutes old on a race page.
- When the week ends, the Past Weeks panel keeps each week's totals, its winner and the weeks won per racer, for up to 26 weeks.
If you start a race with someone you already race, Git Racer opens the existing race instead of making a new copy, so your history builds up in one place.
The numbers come from GitHub's contribution calendar, fetched the same way for everyone, so you are both measured as the public sees you. That means a commit that isn't on your graph isn't in the race. The email, branch and fork rules in the post above apply here too.
Which one should you pick?
| Side by side | Stats board | Weekly race | |
|---|---|---|---|
| Period | A year at a time | Week, month or year | One week, then it resets |
| Has a winner | No | Leaderboard | Yes, every week |
| Setup | None | Sign in, invite code | Sign in, pick a username |
Organizations can't race, because they have no contribution calendar. Everyone you race needs a personal GitHub account.
FAQ
Can I compare with someone who doesn't use Git Racer?
Yes. A race needs only their GitHub username, since the counts come from their public contribution calendar.
Does it count private repo commits?
It reads the contribution calendar, which includes private contributions only if the person chose to show them on their profile. It has no repo access and can't see which repos you worked in.
Can I race someone famous?
Yes. Git Racer suggests 12 well-known developers, including Linus Torvalds, DHH and Andrej Karpathy.
Does it count only commits?
No. It uses the calendar, so every contribution type that GitHub counts is included.
Try it
If you want a winner by Sunday, start a race on Git Racer against a friend. Who do you think takes the first week?
Start a race on Git Racer