Skip to content

phlx0/ghscope


ghscope

x-ray vision for any GitHub repository — straight from your terminal


CI Go Version Latest Release License: GPL-3.0


ghscope in action

One command. Nine tabs. Everything GitHub doesn't show you on the repo page.

ghscope torvalds/linux

Star geography, contributor bus factor, commit heatmaps, dependency staleness, PR velocity, CI/CD signals, trending momentum — all cached locally, all without leaving your terminal.


What's inside

Overview — stars, forks, watchers, open issues, last push, trending signal (rising / stable / declining based on star velocity)

Languages — byte-breakdown bar chart, every language in the repo

Contributors — top contributors ranked by commits, bus factor score, stickiness ratio (one-timers vs returners)

Geography — country breakdown of your stargazers, read from their GitHub profiles

Activity — weekly commit heatmap by day × hour, 52-week sparkline

Releases — full release history, cadence, days since last tag

Health — CI/CD detection, test presence, active forks, issue debt, community files

Deps — outdated packages across Go, Rust, Node, Python with major-version flags

PRs — merge rate, avg time to merge, open count, recent merged vs rejected


Install

# Go
go install github.com/phlx0/ghscope@latest

Or grab a pre-built binary for macOS, Linux, or Windows.

Build from source
git clone https://github.com/phlx0/ghscope
cd ghscope
go build -o ghscope .

Usage

ghscope <owner/repo> [flags]

  --skip-geo     skip star geography  (saves ~100 API calls)
  --skip-deps    skip dependency version checks
  --no-cache     ignore cache and re-fetch everything

  setup          re-run the setup wizard
  cache clear    wipe the local response cache

First run launches a setup wizard to store your GitHub token. Without one you're limited to 60 req/h — enough for small repos, not for anything with real stars.

Token scope needed: public_repo read only.


Keys

  1 – 9       jump to tab          o     open repo in browser
  h / l       prev / next tab      ?     help overlay
  j / k       scroll               q     quit

How it caches

Everything lands in ~/.cache/ghscope/ as SHA256-keyed JSON files.

Data TTL
Repo metadata, languages, contributors 6 hours
Static file checks (CI, tests) 24 hours
PR data 1 hour

ghscope cache clear or --no-cache to start fresh.


Config

Stored at ~/.config/ghscope/config.json. Run ghscope setup to edit it interactively.

{
  "github_token": "ghp_...",
  "skip_geo": false,
  "skip_deps": false
}

Contributing

See CONTRIBUTING.md — the short version: go test ./..., keep the api → analysis → ui layering intact, one thing per PR.

License

GPL-3.0

About

Analyse any GitHub repository from your terminal — stars, contributors, churn, deps, PR velocity and more

Topics

Resources

License

Contributing

Security policy

Stars

Watchers

Forks

Packages

 
 
 

Contributors