Skip to main content

CLI to scan directories for git repositories and get a quick overview of their status

Project description

ggit

An interactive TUI to scan directories for git repositories and get a quick overview of their status.

Install

Homebrew

brew install denrou/ggit/ggit

pip / uv

uv tool install ggit

Usage

Launch the TUI scanning the current directory:

ggit

Scan a specific directory:

ggit ~/code

The TUI displays a table of all discovered repositories with their branch, status, origin, PR counts, and last commit date. Use the keyboard to navigate, sort, filter, and view details.

Keybindings

Key Action
j / k Move cursor down / up
Enter Show detailed info for selected repo
Space Toggle select current row
x Toggle select all visible rows
f Fetch selected repos (or cursor row)
p Prune selected repos (or cursor row)
s Cycle sort: Name → Branch → Last Commit
r Toggle reverse sort
d Filter: dirty repos only
c Filter: clean repos only
a Show all repos (clear filter)
q Quit
Escape Back (from detail screen)

Status symbols

  • clean
  • M modified
  • + staged
  • ? untracked
  • ahead of remote

Detail screen

Press Enter on any repo to see detailed info: branches, last fetch, and authors. Press Escape to go back.

License

MIT

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

ggit-0.4.0.tar.gz (120.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

ggit-0.4.0-py3-none-any.whl (9.2 kB view details)

Uploaded Python 3

File details

Details for the file ggit-0.4.0.tar.gz.

File metadata

  • Download URL: ggit-0.4.0.tar.gz
  • Upload date:
  • Size: 120.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for ggit-0.4.0.tar.gz
Algorithm Hash digest
SHA256 6fd66dc9b10f34d463c42f5a6a25c62768a1789be0f516fb922dd0add36bd3d2
MD5 3c1db3f1a79f64567d132246a5dd0736
BLAKE2b-256 2cb7c574f99b108c5be8a2e86d13f8be7009236b3b1a98316c43f62236067962

See more details on using hashes here.

Provenance

The following attestation bundles were made for ggit-0.4.0.tar.gz:

Publisher: python-publish.yml on denrou/ggit

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file ggit-0.4.0-py3-none-any.whl.

File metadata

  • Download URL: ggit-0.4.0-py3-none-any.whl
  • Upload date:
  • Size: 9.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for ggit-0.4.0-py3-none-any.whl
Algorithm Hash digest
SHA256 9f8ca58e5b5fd8b1c8ef649596d696fc1a953d6c25a71f58e0fcea37bd8bb6fb
MD5 121b5078b499347f070f4b0084f22960
BLAKE2b-256 1b40b60accb6ea92ce7ccf50ec36dff5203f33f1a2a7566ff280e8b0cf444f4a

See more details on using hashes here.

Provenance

The following attestation bundles were made for ggit-0.4.0-py3-none-any.whl:

Publisher: python-publish.yml on denrou/ggit

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page