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.5.0.tar.gz (121.9 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.5.0-py3-none-any.whl (9.8 kB view details)

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for ggit-0.5.0.tar.gz
Algorithm Hash digest
SHA256 29223bd1547da92f6d5f877bf33ec3d80f81b20f85ef3983157c8ee509214df4
MD5 3e4e16ef684926bd0377265dfbaa7ac9
BLAKE2b-256 068ff55ebd0bcb86ffe8d1cfc49271096fe80512f8cfe11cd2ca6ee18587ea6c

See more details on using hashes here.

Provenance

The following attestation bundles were made for ggit-0.5.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.5.0-py3-none-any.whl.

File metadata

  • Download URL: ggit-0.5.0-py3-none-any.whl
  • Upload date:
  • Size: 9.8 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.5.0-py3-none-any.whl
Algorithm Hash digest
SHA256 2dbec524bc7d94bf8e5369b076f09d414ed4c46072690259644c18dde706b43c
MD5 17ce34bb896d0f42cfaa786ff29fb112
BLAKE2b-256 79142a86c6ad0a68e055397d60707340d182d7d55d43e4cb5c3527c2b10c6026

See more details on using hashes here.

Provenance

The following attestation bundles were made for ggit-0.5.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