git-statuses 0.3.0

A tool to display git repository statuses in a table format
git-statuses-0.3.0 is not a library.

git-statuses

Crates.io MIT licensed CI

A command-line tool to display the status of multiple Git repositories in a clear, tabular format.

Features

  • Scans directories recursively for Git repositories
  • Displays status (clean/dirty, branch, etc.) in a table
  • Fast and user-friendly CLI
  • Useful for developers managing many repositories

Example

Installation

You need Rust installed.

cargo install git-statuses

Installation with cargo-binstall:

cargo binstall git-statuses

Or clone and build manually:

git clone https://github.com/bircni/git-statuses.git

cd git-statuses

cargo build --release

Usage

Run in any directory to scan for Git repositories:

A tool to display git repository statuses in a table format

Usage: git-statuses.exe [OPTIONS] [DIR]

Arguments:
  [DIR]  Directory to scan [default: .]

Options:
  -d, --depth    Recursively scan all subdirectories to the given depth. If set to 1, only the current directory is scanned
  -r, --remote   Show remote URL
  -s, --summary  Show a summary of the scan
  -f, --fetch    Run a fetch before scanning to update the repository state Note: This may take a while for large repositories
  -l, --legend   Print a legend explaining the color codes and statuses used in the output
  -h, --help     Print help
  -V, --version  Print version

Output

The tool prints a table with the following columns:

  • Path
  • Branch
  • Status (clean/dirty)
  • Ahead/Behind

Development

  • Requires Rust 1.85+ (edition 2024)
  • Linting: cargo clippy
  • Tests: cargo test

Contributing

Contributions are welcome! Please open issues or pull requests.