gits-statuses 0.0.4

A CLI tool to scan directories for Git repositories and display their status information.

gits-statuses

A CLI tool for scanning directories and displaying Git repository status information. This tool provides a comprehensive overview of all your Git repositories in a clean, tabular format.

Prerequisites

• uv

Install

Note: This CLI tool will eventually be published to PyPi but for now, will need to be manually installed.

# Clone the repository
git clone https://github.com/nicolgit/gits-statuses.git

# Change into the directory
cd gits-statuses/python-pypi/

# Install the package
uv run pip install .

# Activate virtual env
source .venv/bin/activate # macos
.venv\Scripts\activate # windows

# Verify installation
gits-statuses --version

Usage

Basic Commands

# Basic usage - scan current directory
gits-statuses

# Detailed view with remote URLs and total commits
gits-statuses --detailed

# Scan a specific directory
gits-statuses --path /path/to/projects

# Show help
gits-statuses --help

Examples

Standard view (shows only repositories with changes):

Repository    | Branch | Ahead | Behind | Changed | Untracked
-------------------------------------------------------------
gits-statuses | main   | 1     |        | 1       | 1        
my-project    | dev    | 2     |        | 3       | 2        
web-app       | main   |       | 2      | 1       |          

Summary:
  Total repositories: 5
  Repositories with changes: 3
  Repositories ahead of remote: 2
  Repositories behind remote: 1
  Repositories with untracked files: 2

Detailed view (shows all repositories):

Repository    | Branch | Ahead | Behind | Changed | Untracked | Total Commits | Status   | Remote URL                               
---------------------------------------------------------------------------------------------------------------
api-service   | main   |       |        |         |           | 45            | Clean    | https://github.com/user/api-service
gits-statuses | main   | 1     |        | 1       | 1         | 9             | ↑1 ~1 ?1 | https://github.com/nicolgit/gits-statuses
my-project    | dev    | 2     |        | 3       | 2         | 67            | ↑2 ~3 ?2 | https://github.com/user/my-project
utils-lib     | main   |       |        |         |           | 23            | Clean    | https://github.com/user/utils-lib
web-app       | main   |       | 2      | 1       |           | 102           | ↓2 ~1    | https://github.com/user/web-app

Summary:
  Total repositories: 5
  Repositories with changes: 3
  Repositories ahead of remote: 2
  Repositories behind remote: 1
  Repositories with untracked files: 2

Status Symbols

• ↑n: n commits ahead of remote
• ↓n: n commits behind remote
• ~n: n changed files (modified/added/deleted)
• ?n: n untracked files
• Clean: Repository has no pending changes

Examples:

• ↑2 ~1 ?3 = 2 commits ahead, 1 changed file, 3 untracked files
• ↓1 ~2 = 1 commit behind, 2 changed files
• Clean = No changes, fully synchronized