github-discover-cli

中文 | English

A lightweight CLI tool to discover newly created and fast-growing open-source repositories and trending topics on GitHub.

Uses the GitHub Search API to filter high-star repos, track growth trends, and surface tech hotspots by day, week, month, or year.

Features

• trending — Smart ranking by stars-per-day, highlighting truly fast-rising projects
• popular — Newly created high-star repos within a given time period, sorted by star count
• topic — Trending topics across popular repos, scored by frequency and total stars
• Filter by programming language, with output as a terminal table or JSON

Installation

Requires Node.js 18+.

git clone https://github.com/coderyi/github-discover-cli.git
cd github-discover-cli
npm install && npm run build

Usage

trending — Growth Trends

Ranks repos by stars-per-day (with age smoothing), rather than raw star count.

github-discover trending                         # fastest growing repos recently
github-discover trending -p monthly -l Python    # monthly, Python only

popular — Popular New Repos

github-discover popular                          # popular repos from the past day
github-discover popular -p weekly -l Rust        # past week, Rust only
github-discover popular -p monthly -n 10 --json  # monthly, top 10, JSON output

topic — Topic Insights

Aggregates frequent topic tags from popular repos, scored by occurrence count and total associated stars.

github-discover topic                            # recent trending topics
github-discover topic -p yearly -n 20            # yearly, top 20

Options

All subcommands support the following options:

| Option | Short | Description | Default | | --- | --- | --- | --- | | --period <period> | -p | Time window: daily | weekly | monthly | yearly | daily | | --limit <number> | -n | Number of results (1–100) | 50 (topic: 30) | | --language <lang> | -l | Programming language filter | none | | --min-stars <number> | -s | Minimum star threshold | auto by period * | | --json | — | Output as JSON | false |

* --min-stars defaults: daily 60 · weekly 500 · monthly 4000 · yearly 10000

Output Examples

Table mode (default):

| Name | Stars | Lang | Created | URL | Description | | ------------ | ----- | ---------- | ---------- | ------------------------------- | ----------- | | owner1/repo1 | 1234 | TypeScript | 2026-03-09 | https://github.com/owner1/repo1 | description |

JSON mode — pipe to jq for further processing:

github-discover trending --json | jq '.[].full_name'

License

MIT