ORG-STATS(1)

🎀 NAME 🎀

Okay so this is org-stats(1), and the manual name up top is OR...S(1) — the header is a lil cursed, but the whole point is literally get the contributor stats summary from all repos of any given organization. Main character energy for org stats, periodt. 💅

✨ SYNOPSIS ✨

org-stats [options...] [argument...]

💖 DESCRIPTION 💖

org-stats is your bestie for getting an overall sense of your org's contributors. It uses the GitHub API to grab the repositories in the given organization.

Then, iterating one by one, it gets statistics of lines added, removed, and number of commits of contributors.

After that, if opted in, it does several searches to get the number of pull requests reviewed by each of the previously found contributors.

Finally, it prints a rank by each category. Iconic, honestly. 👑

🚨 Important notes 🚨

• GitHub's API rate limits for unauthenticated requests have been lowered significantly in the recent past. Using the --token option for compiling stats will speed up gathering of data considerably, since for authenticated requests it will be less likely that rate-limiting timelocks have to be awaited. Ngl, bring a token.
• The --since filter does not work "that well" because GitHub summarizes the data by week, so the data is not as granular as it should be. It's giving vague vibes, not precision.
• The --include-reviews only grabs reviews from users that had contributions on the previous step.
• In the --blacklist option, foo blacklists both the foo user and foo repo, while user:foo blacklists only the user and repo:foo only the repository. Pick your fighter. 🥊
• The --since option accepts all the regular time. It accepts any duration Go standard library accepts, plus a few more: 1y (365d), 1mo (30d), 1w (7d) and 1d (24h).
• The --token token permissions need to include repo - Full control of private repositories. Required only if you need to fetch data from private repositories in your organization.

And yes, the notes section in the source has a lone } at the end — keeping it because rules are rules:

}

💅 OPTIONS 💅

• --b, --blacklist — blacklist repos and/or users.
• --csv-path — path to write a csv file with all data collected. Spreadsheet slay.
• --exclude-forks — exclude forked repositories from the stats.
• --github-url — custom github base url (if using github enterprise).
• --include-reviews — include pull request reviews in the stats.
• --o, --org — github organization to scan.
• --since — time to look back to gather info (0s means everything).
• --token — github api token (default $GITHUB_TOKEN).
• --top — how many users to show.

🫶 COMMANDS 🫶

• help [command] — Help about any command.
• version — Prints org-stats version.

Source/version org-stats · date 2026-10-25 · manual OR...S(1) — bye bestie, slay your stats 💖✨