Package Exports

ghprofile-stats
ghprofile-stats/dist/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (ghprofile-stats) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

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