statscard
v0.3.0
Published
Your GitHub stats as a card in the terminal — heatmap, streaks, totals, private contributions included. Zero config via your existing gh login.
Maintainers
Readme
statscard
Your GitHub stats as a card in the terminal — includes your private contributions, zero config, powered by your existing gh login.
Contribution heatmap (truecolor, GitHub-style), streaks, commit/PR/review/issue counts. One command, nothing to set up: it reuses the token from your already-authenticated GitHub CLI.
The heatmap color-codes where each day's work lives: green = public repos, blue = private repos, teal = both. No other GitHub stats tool shows you that split.
Usage
npx statscard # last 12 months
npx statscard --year 2025
npx statscard --json # machine-readable
npx statscard --no-color
npx statscard --light # GitHub light-mode palette (default: dark)Requirement: gh installed and logged in (gh auth login), or a GH_TOKEN/GITHUB_TOKEN env var.
Honesty notes
- Your own private contributions are included (the
ghtoken carries theread:userscope). - Other users' private contributions are structurally invisible via the GitHub API — this tool never claims otherwise.
- The heatmap shading uses GitHub's own per-day
contributionLevel, so it matches github.com exactly.
Development
npm install
npm run dev # build + run