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.1.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.1-py3-none-any.whl (9.8 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: ggit-0.5.1.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.1.tar.gz
Algorithm Hash digest
SHA256 adae0d9ebb9332e95f5651c94ec843dd1560c1d7b024f84b2830df0c840de041
MD5 81e5ea0519d6d10b9c3f27b4206d1675
BLAKE2b-256 51b233859b5e543615a190fcd8d6f14de8f192e0b32005489a248059c83aaf5d

See more details on using hashes here.

Provenance

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

File metadata

  • Download URL: ggit-0.5.1-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.1-py3-none-any.whl
Algorithm Hash digest
SHA256 d05f002bbffe8aaa2e013ea347098f65c72c0e71f651b85cb2ce3fd0f6426790
MD5 b2a635ce956bb51f0aa1cc191bc0b5cc
BLAKE2b-256 7c80eeece407e4b7dd80a74157c41c4e7ac2a11d6a4ad2b534c5bbb1a60dc2c7

See more details on using hashes here.

Provenance

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