Zero dependencies. Reads the same pipeline the web terminal reads, printed in honest monospace. Pipe through jq, tail the event stream, or just glance at what's moving without opening a browser.
The CLI hits the live Portal pipeline directly — no clone, no setup. Node 18+ is the only prerequisite.
# Pipe straight from the live Vercel deployment npx github:0motionguy/starscreener \ trending --window=24h --limit=10 # Or export the API base and keep the command short across a session export STARSCREENER_API_URL=https://starscreener.vercel.app npx github:0motionguy/starscreener trending --limit=5
Or via the Portal v0.1 visitor CLI
Same data, spec-native. Works against any /portal endpoint on the open agent web.
# Spec-native Portal v0.1 visitor CLI — works against /portal # on any provider that publishes a manifest, not just TrendingRepo. npx @visitportal/visit https://starscreener.vercel.app/portal top_gainers --limit=5
Local dev
# From a local checkout against npm run dev npm run cli:dev -- trending --window=24h --limit=10 # Or run the bin directly STARSCREENER_API_URL=https://starscreener.vercel.app node bin/ss.mjs trending
Every command accepts STARSCREENER_API_URL=https://… to point at a non-default API.
ss trending [--window=24h|7d|30d] [--limit=20]Top movers for a time window. Default: 7d.
ss breakouts [--limit=20]Repos currently flagged as breakouts by the classifier.
ss new [--limit=20]Repos created in the last 30 days.
ss search <query> [--limit=10]Full-text search over name, description, and topics.
ss repo <owner/name>Detailed view of one repo — stars, deltas, momentum, release.
ss compare <a/b> <c/d> [...]Side-by-side comparison of stars, forks, deltas, momentum.
ss categoriesList of categories with repo counts and average momentum.
ss stream [--types=...]Tail the live SSE event stream — rank changes, breakouts, alerts.
Every command accepts --json for machine-readable output. Exit code is 0 on success, 1 on error, 130 on Ctrl-C.
What a 24-hour movers check actually looks like on a wide terminal:
$ ss trending --window=24h --limit=5 Trending repos (window=24h, showing 5 of 212) # REPO STARS 24H 7D MOMENTUM STATUS - ------------------------------ ------- ------- ------ -------- -------- 1 anthropics/claude-code 48,214 +1,204 +6,880 94.2 hot 2 microsoft/vscode-copilot 92,101 +874 +3,120 88.7 breakout 3 mlabonne/llm-course 41,502 +612 +2,045 81.3 rising 4 ollama/ollama 112,880 +548 +1,982 79.1 rising 5 vercel/ai 12,044 +421 +1,210 74.8 rising