Skip to main content

gha list

Overview​

Lists repositories for a GitHub user or organization with optional filtering by visibility and archive status. Useful for getting a quick inventory of repos across accounts.

Usage​

python -m src.cli list [OPTIONS]

Options​

OptionDescriptionDefault
-u, --user USERNAMEGitHub usernameAuthenticated user
-o, --org NAMEOrganization name--
--visibility {public,private}Filter by visibilityAll
--include-archivedInclude archived reposExcluded
--format {console,json}Output formatconsole

Prerequisites​

  • Repo: github-automator
  • Install: pip install -r requirements.txt from repo root
  • Environment: GITHUB_TOKEN or account-specific tokens

Examples​

List all repos for the authenticated user​

python -m src.cli list

List repos for a specific organization​

python -m src.cli list --org symphonycore-org

List only private repos as JSON​

python -m src.cli list --visibility private --format json