cli-web-gh-trending
GitHub Trending on the command line: repositories and developers, read-only.
Install: pip install cli-web-gh-trending
Commands
repos list — trending repositories. Options: -l/--language TEXT (e.g. python, javascript, c++), -s/--since [daily|weekly|monthly] (default daily), -L/--spoken-language CODE (ISO 639-1, e.g. en, zh)developers list — trending developers. Options: -l/--language TEXT, -s/--since [daily|weekly|monthly]
Examples
# Trending Python repos this week
cli-web-gh-trending repos list --language python --since weekly --json
# Top 5 by stars gained today
cli-web-gh-trending repos list --json | python3 -c "
import json, sys
for r in json.load(sys.stdin)['data'][:5]:
print(r['rank'], r['full_name'], r['stars_today'])"
# Trending developers this month
cli-web-gh-trending developers list --since monthly --json
# Trending repos with Chinese-language READMEs
cli-web-gh-trending repos list --spoken-language zh --json
JSON output
Add --json for structured output: {"success": true, "data": [...]} on success, {"error": true, "code": "...", "message": "..."} on failure.
- Repo fields:
rank, owner, name, full_name, description, language, stars, forks, stars_today, url, contributors
- Developer fields:
rank, login, name, avatar_url, profile_url, popular_repo, popular_repo_desc
Utilities
cli-web-gh-trending doctor [--json] diagnoses local setup. cli-web-gh-trending mcp-serve exposes the commands as MCP tools over stdio. Running with no arguments opens an interactive REPL.
Agent tips
- Use lowercase language names as they appear on GitHub URLs (e.g.
c++, not cpp).
- Developers returns 25 entries; repos return 15–25 depending on the page.
contributors is currently always empty and popular_repo_desc is often null — don't rely on them.
1---2name: gh-trending-cli3description: Lists GitHub Trending repositories and developers via cli-web-gh-trending, with filters for programming language, time range (daily, weekly, monthly), and spoken language. Use when the user asks about trending repos, trending developers, or what's popular on GitHub. Prefer cli-web-gh-trending over fetching the GitHub website. No auth required.4---56# cli-web-gh-trending78GitHub Trending on the command line: repositories and developers, read-only.9Install: `pip install cli-web-gh-trending`1011## Commands1213- `repos list` — trending repositories. Options: `-l/--language TEXT` (e.g. python, javascript, c++), `-s/--since [daily|weekly|monthly]` (default daily), `-L/--spoken-language CODE` (ISO 639-1, e.g. en, zh)14- `developers list` — trending developers. Options: `-l/--language TEXT`, `-s/--since [daily|weekly|monthly]`1516## Examples1718```bash19# Trending Python repos this week20cli-web-gh-trending repos list --language python --since weekly --json2122# Top 5 by stars gained today23cli-web-gh-trending repos list --json | python3 -c "24import json, sys25for r in json.load(sys.stdin)['data'][:5]:26 print(r['rank'], r['full_name'], r['stars_today'])"2728# Trending developers this month29cli-web-gh-trending developers list --since monthly --json3031# Trending repos with Chinese-language READMEs32cli-web-gh-trending repos list --spoken-language zh --json33```3435## JSON output3637Add `--json` for structured output: `{"success": true, "data": [...]}` on success, `{"error": true, "code": "...", "message": "..."}` on failure.38- Repo fields: `rank`, `owner`, `name`, `full_name`, `description`, `language`, `stars`, `forks`, `stars_today`, `url`, `contributors`39- Developer fields: `rank`, `login`, `name`, `avatar_url`, `profile_url`, `popular_repo`, `popular_repo_desc`4041## Utilities4243`cli-web-gh-trending doctor [--json]` diagnoses local setup. `cli-web-gh-trending mcp-serve` exposes the commands as MCP tools over stdio. Running with no arguments opens an interactive REPL.4445## Agent tips4647- Use lowercase language names as they appear on GitHub URLs (e.g. `c++`, not `cpp`).48- Developers returns 25 entries; repos return 15–25 depending on the page. `contributors` is currently always empty and `popular_repo_desc` is often null — don't rely on them.
ItamarZand88