github-readme-stats

Rust CLI to fetch GitHub user statistics as JSON.

Installation

Download from Releases or build from source:

cargo install --git https://github.com/lucifer1004/github-readme-stats

Usage

export GHT="ghp_your_token"
github-readme-stats your-username -o stats.json

Configuration file

Create github-readme-stats.toml in the working directory for optional settings (token stays in GHT env only).

[time]
timezone = "+08:00"       # UTC offset for time distribution

[repos]
pinned = ["owner/repo1", "owner/repo2"]  # repos to fetch detailed stats for

[language]
commits_limit = 1000          # max commits to sample (default 1000)
top_n = 10                    # top N languages to include (default 10)
exclude = ["HTML", "CSS"]     # languages to exclude (case-insensitive)
types = ["programming"]       # Linguist types to include (default: ["programming"])

Environment Variables

Output

JSON with the following structure:

{
  "name": "Display Name",
  "username": "github-username",
  "repos": 42,
  "stars": 100,
  "forks": 25,
  "followers": 50,
  "commits": 1234,
  "prs": 56,
  "issues": 78,
  "account_age_years": 5,
  "account_age_days": 1825,
  "contribution_calendar": { ... },
  "streaks": { ... },
  "pinned_repos": [ ... ],
  "time_distribution": { ... },
  "language_usage": [ ... ],
  "language_total_changes": 12345,
  "language_sampled_commits": 1000
}

Notes

• Profile and contribution data are fetched via GraphQL; commit sample, time distribution, and language stats use REST.
• language_usage is derived from commit file changes (additions + deletions), not repo sizes.
• Language detection uses a build-time snapshot of GitHub Linguist languages.yml. To update, re-download data/languages.yml and rebuild.
• By default, only programming languages are included. Set language.types to ["programming", "markup"] etc. to widen the filter. Valid types: programming, data, markup, prose.
• Time distribution and language usage share the same commit sample (language.commits_limit).
• Language stats can be rate-limit heavy because each sampled commit fetches commit details.

Used by

• github-stats-typst — GitHub Action to render stats as SVG cards

License

MIT