GitHub Trending Report

# GitHub Trending Report

Use the `github-discover` CLI to fetch real-time GitHub data and generate structured trending reports — discover fast-rising repositories, newly popular projects, and hot topic tags.

Installation

npm install -g github-discover

> Requires Node.js 18+. Check with `node --version`.

Prerequisites

Commands

trending — Fastest-growing repositories

Ranked by daily average stars with a 30-day smoothing factor, removing age bias to surface genuinely fast-rising projects.

github-discover trending [options]

| Option | Description | Default |

|---|---|---|

| `-p` | Period: daily / weekly / monthly / yearly | daily |

| `-n` | Number of results (1–100) | 50 |

| `-l` | Filter by programming language (e.g. python, typescript) | all |

| `-s` | Minimum star threshold | auto by period |

| `--json` | Output as JSON | — |

popular — New high-star repositories

Sorted by raw star count descending, focused on recently created high-popularity projects.

github-discover popular [options]

Same options as `trending`.

topic — Hot topic tags

Scored by `repoCount × log10(starSum)` to surface trending technology topics.

github-discover topic [options]

| Option | Description | Default |

|---|---|---|

| `-p` | Period: daily / weekly / monthly / yearly | daily |

| `-n` | Number of results (1–100) | 30 |

| `--json` | Output as JSON | — |

Data Windows (trending command)

| Period | Repository creation range |

|---|---|

| daily | Created within last 7 days |

| weekly | Created within last 28 days |

| monthly | Created within last 90 days |

| yearly | Created within last 730 days |

Standard Workflow for Generating a Report

When a user requests a GitHub trending report, follow these steps:

**Step 1: Verify the tool is available**

github-discover --version

If the command is not found, prompt the user to run `npm install -g github-discover`, then stop.

**Step 2: Determine the time period**

Infer the period from the user's request:

**Step 3: Fetch all three data sets in parallel**

github-discover trending -p <period> -n 10 --json
github-discover popular  -p <period> -n 10 --json
github-discover topic    -p <period> -n 10 --json

If the user specified a language (e.g. Python, TypeScript), append `-l <language>` to the `trending` and `popular` commands.

**Step 4: Generate the structured report**

Combine the JSON output from all three commands and produce a report in the following format:

---

📈 GitHub <Period> Trending Report

1. Fastest-Growing Projects

> Source: `trending` — reflects real growth velocity, age bias removed

List Top 5–10 entries, each with:

2. Newly Popular Repositories

> Source: `popular` — recently created projects gaining rapid traction

List Top 5–10 entries, same format as above.

3. Hot Topics

> Source: `topic` — scored by repository count × star magnitude

List Top 10 topic tags with a brief description of each technology area.

4. AI Insights

Based on the data above, provide:

---

Limitations