ghstats-cli

A powerful GitHub profile and repository statistics analyzer that outputs beautiful CLI dashboards. Instantly analyze any GitHub user's profile, compare developers side by side, or inspect repository details.

Features

• User Profile Dashboard -- repos, stars, forks, followers, language breakdown, recent activity
• Repository Inspector -- stars, forks, watchers, issues, topics, license, and more
• Side-by-Side Comparison -- compare multiple GitHub profiles in a single table
• Language Breakdown -- visual bar chart of languages across all repos
• Recent Activity Feed -- categorized summary of public events
• JSON Output -- pipe data to other tools with --json
• Rate Limit Awareness -- warns before hitting GitHub API limits
• Auto-detection -- pass a username, owner/repo, or full GitHub URL

Installation

npm install -g ghstats-cli

Usage

Analyze a User

ghstats chengyixu
# or
ghstats user chengyixu

Output:

  ╔═══════════════════════════════════════╗
  ║     ghstats-cli  v1.0.0              ║
  ║     GitHub Profile Analyzer           ║
  ╚═══════════════════════════════════════╝

  ── Profile ──────────────────────────────────

  Wilson Xu (@chengyixu)

  Repos  Stars  Forks  Followers  Following
  129    9      4      8          42

  Location: United States
  Joined: January 18, 2020

  ── Top 10 Repositories by Stars ────────────

  ┌─────┬────────────────────────┬───────┬───────┬────────────┬─────────┐
  │ #   │ Repository             │ Stars │ Forks │ Language   │ Updated │
  ├─────┼────────────────────────┼───────┼───────┼────────────┼─────────┤
  │ 1   │ openclaw-browser-relay │ 6     │ 2     │ JavaScript │ 12d ago │
  │ 2   │ xhs-ai-publisher      │ 1     │ 0     │ Python     │ 7mo ago │
  │ ... │ ...                    │       │       │            │         │
  └─────┴────────────────────────┴───────┴───────┴────────────┴─────────┘

  ── Language Breakdown ────────────────────────

  Jupyter Notebook ██████████████████████████████ 16 repos (18.4%)
  Python           ██████████████████████████     14 repos (16.1%)
  HTML             ██████████████████████████     14 repos (16.1%)
  JavaScript       █████████████████              9 repos (10.3%)
  Go               ███████████                    6 repos (6.9%)
  TypeScript       ████████                       4 repos (4.6%)

  ── Recent Activity (last 90 days) ───────────

  Pushes             31
  Issue Comments     25
  Stars Given        23
  Pull Requests      6

Analyze a Repository

ghstats facebook/react
# or
ghstats repo https://github.com/facebook/react

Output:

  ── Repository: facebook/react ──────────

  The library for web and native user interfaces.

  Stars   Forks  Watchers  Issues
  244.0K  50.8K  244.0K    1.2K

  Language: JavaScript
  License: MIT
  Topics: declarative, frontend, javascript, library, react, ui
  Created: 5/25/2013
  Last push: 10h ago

Compare Profiles

ghstats compare chengyixu torvalds sindresorhus

Output:

  ┌──────────────┬──────────────┬────────────────┬───────────────┐
  │ Metric       │ @chengyixu   │ @torvalds      │ @sindresorhus │
  ├──────────────┼──────────────┼────────────────┼───────────────┤
  │ Repos        │ 87           │ 8              │ 1100+         │
  │ Total Stars  │ 9            │ 234.3K         │ 500K+         │
  │ Followers    │ 8            │ 291.5K         │ 55K+          │
  │ Primary Lang │ Jupyter NB   │ C              │ TypeScript    │
  └──────────────┴──────────────┴────────────────┴───────────────┘

JSON Output

ghstats chengyixu --json > profile.json
ghstats repo facebook/react --json | jq '.stars'

Options

| Option | Description | |---------------|--------------------------------------| | -t, --top N | Number of top repos to show (default: 10) | | --json | Output raw JSON instead of dashboard | | -V | Show version | | -h | Show help |

Authentication (Optional)

Without authentication, GitHub allows 60 API requests per hour. For higher limits (5,000/hr), set a token:

export GITHUB_TOKEN=ghp_your_token_here
ghstats torvalds

The tool also respects GH_TOKEN (used by the GitHub CLI).

Use Cases

• Portfolio Building -- quickly see your GitHub stats for resumes and portfolios
• Recruiter Screening -- evaluate a candidate's open source contributions at a glance
• Team Assessment -- compare team members' GitHub activity
• Repo Research -- inspect any repository's health and community metrics
• CI/CD Integration -- use --json to pipe stats into other tools or dashboards

License

MIT