Stargazers is a CLI tool that pulls the raw event data behind a GitHub star count and turns it into CSVs and terminal summaries. Instead of a running total, you get a daily star history, enriched stargazer profiles, traffic and clone counts, and issue throughput stats.
Features
- Star history: Reconstruct daily and cumulative star counts from the underlying
starred_atevents - Stargazer and forker profiles: Enrich each user with followers, company, and location
- Account-wide trends: Aggregate every repository you own into one growth curve
- Traffic: Views, clones, and referrers per repository
- Contributors and issues: Commit counts, time-to-close percentiles, and author breakdowns
- CSV output: Every command writes a CSV alongside its terminal summary
- Terminal plots: Chart any saved CSV without leaving the shell
Installation
brew install wdm0006/tap/stargazers
Or install it directly from source with uv:
uv tool install git+https://github.com/wdm0006/stargazers
Note that the stargazers package on PyPI is an unrelated project by a different author.
Setup
Most commands need a GitHub token. Without one you will hit the unauthenticated rate limit quickly:
export GITHUB_TOKEN=$(gh auth token)
The token is also read from a .env file in the working directory.
Usage
# Stargazers and forkers for one or more repositories
stargazers repos wdm0006/pygeohash
stargazers forkers wdm0006/elote
# Daily star history across every repository an account owns
stargazers account-trend wdm0006 --line-chart
# Include repositories you contribute to but do not own
stargazers account-trend wdm0006 --include-repo scikit-learn-contrib/category_encoders
# Views, clones, and referrers (requires push access to the repositories)
stargazers traffic wdm0006
# Contributor and issue analytics
stargazers contributors wdm0006/git-pandas
stargazers issues wdm0006/git-pandas wdm0006/keeks
# Plot a CSV you already generated
stargazers plot --file wdm0006_account_stars_by_day.csv --type account-trend
Limits
- GitHub’s traffic API retains only the last 14 days, and it requires push access, so
trafficworks on your own repositories only. - Star history is reconstructed from surviving star events, so anyone who starred and later unstarred does not appear.