git-statuses

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

Installation

With Homebrew on macOS (Apple Silicon and Intel) or Linux (x86_64):

brew install bircni/tap/git-statuses

This also installs the bash, zsh and fish completions.

With Cargo, which needs 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 [OPTIONS] [DIR]

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

Options:
  -d, --depth <DEPTH>        Recursively scan all subdirectories to the given depth. If set to 1, only the current directory is scanned. If set to a negative value, all subdirectories are scanned. (this may take a while) [default: 1]
  -r, --remote               Show remote URL
  -c, --condensed            Use a condensed layout
  -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
  -F, --ff                   Run a fast-forward merge after fetching
  -l, --legend               Print a legend explaining the color codes and statuses used in the output
      --subdir <SUBDIR>      Look in a specific subdir if it exists for each folder This can be useful, if you don't checkout in a folder directly but in a subfolder like `repo-name/checkout`
      --completions <SHELL>  Generate shell completions [possible values: bash, elvish, fish, powershell, zsh]
  -p, --path                 Show the path to the repository
  -n, --non-clean            Only show non clean repositories
      --json                 Output in JSON format
  -h, --help                 Print help
  -V, --version              Print version

Output

The tool prints a table with the following columns:

• Directory (relative to the scanned directory, ⎇ marks a worktree)
• Branch
• Local (commits ahead/behind the upstream, or local-only)
• Commits
• Status (run git-statuses --legend for what each one means)
• Remote and Path, with --remote and --path

The report goes to stdout and diagnostics go to stderr, so --json can be piped straight into another tool:

git-statuses --json | jq '.repositories[] | select(.status != "Clean")'

Exit codes

Code	Meaning
0	The scan completed and every repository found was readable.
1	At least one repository was found but could not be processed. The names are listed on stderr.

Development

• Requires the latest stable Rust (1.99+, edition 2024)
• Linting: cargo clippy
• Tests: cargo test

Contributing

Contributions are welcome! Please open issues or pull requests.