Skip to content

davidbrownell/AllGitStatus

Project: License

Package: PyPI - Python Version PyPI - Version PyPI - Downloads

Development: uv ruff ty pytest CI Code Coverage GitHub commit activity

Contents

Overview

AllGitStatus is a Text-based user interface (TUI) application that displays the git status of all repositories found under a specified directory. Perfect for developers managing multiple repositories who need a quick, comprehensive overview of their project states without navigating into each one individually.

screenshot

[Screenshot of AllGitStatus]

demo.mp4

[Demo of AllGitStatus]

Features

Local Git Information:

  • Current branch name with detached HEAD detection
  • Local changes summary (staged βœ…, unstaged 🟑, untracked ❓)
  • Stash count (🧺)
  • Remote sync status showing commits to push (πŸ”Ό) or pull (πŸ”½)

GitHub Integration (when a GitHub PAT is provided):

  • Stars (⭐), forks (🍴), and watchers (πŸ‘€) count
  • Open issues with labels and authors (πŸ›)
  • Open pull requests with draft status (πŸ”€)
  • Security/Dependabot alerts with severity breakdown (πŸ”’πŸ””βš οΈπŸš¨)
  • CI/CD workflow status (βœ…βŒβ³)
  • Repository archived status (πŸ“¦)

How to use AllGitStatus

Run directly with uvx (no installation required):

Check all repositories under the current directory

uvx AllGitStatus

Check repositories under a specific directory

uvx AllGitStatus /path/to/projects

Enable GitHub integration with a Personal Access Token (NOT RECOMMENDED)

uvx AllGitStatus --pat ghp_your_token_here

The PAT can also be a path to a file containing the token (RECOMMENDED)

uvx AllGitStatus --pat ~/.github_pat

Or use an environment variable for the PAT

export ALLGITSTATUS_PAT=ghp_your_token_or_filename_here
uvx AllGitStatus

Enable debug mode for troubleshooting

uvx AllGitStatus --debug

Running as a python package

Install AllGitStatus as a python package using the instructions below.

Command Line Scenario
AllGitStatus To run using the current directory as the root of all git repositories.
AllGitStatus <path to directory> To run using the specified directory as the root of all git repositories.

Installation

Note that installation is not required when running AllGitStatus via uvx.

Installation Method Command
Via uv uv add AllGitStatus
Via pip pip install AllGitStatus

Verifying Signed Artifacts

Artifacts are signed and verified using py-minisign and the public key in the file ./minisign_key.pub.

To verify that an artifact is valid, visit the latest release and download the .minisign signature file that corresponds to the artifact, then run the following command, replacing <filename> with the name of the artifact to be verified:

uv run --with py-minisign python -c "import minisign; minisign.PublicKey.from_file('minisign_key.pub').verify_file('<filename>'); print('The file has been verified.')"

Development

Please visit Contributing and Development for information on contributing to this project.

Additional Information

Additional information can be found at these locations.

Title Document Description
Code of Conduct CODE_OF_CONDUCT.md Information about the norms, rules, and responsibilities we adhere to when participating in this open source community.
Contributing CONTRIBUTING.md Information about contributing to this project.
Development DEVELOPMENT.md Information about development activities involved in making changes to this project.
Governance GOVERNANCE.md Information about how this project is governed.
Maintainers MAINTAINERS.md Information about individuals who maintain this project.
Security SECURITY.md Information about how to privately report security issues associated with this project.

License

AllGitStatus is licensed under the MIT license.

About

Checks the git status for all repositories found under the specified directory.

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages