A CLI that uses the GitHub CLI to locate and inspect files across every repo in an organization, without cloning a single one.
pip install gh-inspectorThe problem
Some questions span a whole organization. Which repos still depend on an old library version? Who owns which files? What Python does each project target? Answering them by hand means cloning repo after repo and grepping through each one, and the answer is out of date as soon as you have it.
The solution
gh-inspector answers those questions in a single command. It queries GitHub through the gh CLI you already use, reads dependency files, CODEOWNERS, and version markers across every repo, and shows you the result. No clones, no local copies to keep in sync.
Ask GitHub what your org looks like. Stop cloning it to find out.
What it does
See which repos use a library, and which version, across the org.
$ gh-inspector find-python-library python django
Version Usage for libraries: django
Version Count Repositories (Files)
5.2.13 1 python/pythondotorg (uv.lock)
3.2.4 1 python/pyperformance (bm_django_template/requirements.txt)
39 repos scanned · 2 with matches · 95 GitHub API calls
Map ownership across the org, grouped by team or person.
$ gh-inspector find-codeowners python
CODEOWNERS by Owner
├── @AlexWaygood
│ └── python/cpython (Lib/typing.py, Doc/library/typing.rst + 4 more)
├── @JacobCoffee
│ ├── python/pythondotorg (entire repo)
│ └── python/psf-salt (*, salt/docs/*, tests/docs-redirects/*)
└── @Mariatta
└── python/peps (peps/pep-0581.rst, peps/pep-0676.rst + 4 more)
76 repos scanned · 9 with CODEOWNERS · 86 GitHub API calls
Detect the Python each repo targets, across runtime, minimum, and CI.
$ gh-inspector find-python-version python
Repository Runtime Minimum CI
pythondotorg 3.12.6 .python >=3.12 —
webhook-mailer 3.7.17 Docker — 3.7 tox.ini
typing — >=3.12 3.12 conformance.yml
mypy — >=3.10 3.10 3 files
typing_extensions — >=3.9 3.9 tox.ini
cpython — — 3.11 jit.yml
25 repos with a version, 14 without · 298 GitHub API calls
gh-inspector shells out to the gh CLI for authentication and API access, so it
inherits whatever login you already use. It never clones a repository: it reads
files through the GitHub API and parses them locally.
Every command supports --format only_repo for terse output, repeatable
--file-types filters, and --all-repositories to include archived and forked
repos. Shell completion is available for bash, zsh, and fish.
GitHub CLI extension. One command.
pip install gh-inspectorgh-inspector is better because of the people who have contributed to it. Thank you.
