gh-star-history

gh-star-history

Visualize GitHub star history and regional breakdown as interactive charts. Powered by the [GitHub CLI](https://cli.github.com/) - no API tokens needed. Features date range selection, star growth tracking with period comparison, and dynamic regional breakdown.

For example, if you want to see the star growth of [claude-code-tips](https://github.com/ykdojo/claude-code-tips):

npx gh-star-history ykdojo/claude-code-tips

Or compare multiple repos:

npx gh-star-history vuejs/vue withastro/astro sveltejs/svelte

Generates a self-contained HTML file with an interactive Plotly chart.

Prerequisites

• Node.js >= 16
• GitHub CLI installed and authenticated (gh auth login)

Usage

npx gh-star-history  ... [options]

Accepts both formats, and multiple repos:

npx gh-star-history ykdojo/claude-code-tips
npx gh-star-history https://github.com/ykdojo/claude-code-tips
npx gh-star-history vuejs/vue withastro/astro sveltejs/svelte

Options

Flag	Description
--style	Chart style: blue (default), green, purple (single repo only)
--output	Output file path (default: star-history.html)
--no-open	Don't auto-open the browser
--no-cache	Skip cache and fetch fresh data
-h, --help	Show help

Examples

# Default blue style
npx gh-star-history ykdojo/claude-code-tips

# Green accent
npx gh-star-history ykdojo/claude-code-tips --style green

# Save to specific file
npx gh-star-history torvalds/linux --output linux-stars.html

# Compare multiple repos
npx gh-star-history vuejs/vue withastro/astro sveltejs/svelte

Styles

Three styles matching GitHub's dark theme palette:

• blue (default) - #58a6ff
• green - #3fb950
• purple - #bc8cff

How it works

1. Fetches stargazer timestamps via GitHub's GraphQL API (no pagination limit)

...