| name | gh-trending-cli |
| description | 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. |
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
cli-web-gh-trending repos list --language python --since weekly --json
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'])"
cli-web-gh-trending developers list --since monthly --json
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.
