git-foreach

git-foreach is a lightweight utility designed to execute a command in each Git repository within a directory and its subdirectories. It's particularly useful for performing bulk operations, such as git pull or git status, across multiple repositories simultaneously.

Usage

To use git-foreach, simply prepend your desired command with git-foreach. The command will be executed in each Git repository found in the current directory and all its subdirectories.

git-foreach <command>

For instance, if you want to execute git pull in each repository, you would use:

git-foreach "git pull"

By default, git-foreach will stop executing if the command fails in one of the repositories. If you want the execution to continue despite failures, you can append || : to the command. This will mask the error and allows git-foreach to continue processing the remaining repositories.

git-foreach "git pull || :"

Installation

Pre-built binaries are available for Windows, Linux, and macOS. You can download them from the releases page and add them to your $PATH. The release page also includes instructions for installation using Homebrew, curl, or PowerShell.

Homebrew

If you're using macOS or Linux, you can install git-foreach using Homebrew:

brew install marcfrederick/homebrew-tap/git-foreach

Building from Source

To build the utility from source, ensure you have Rust installed on your system. Then, execute the following commands:

git clone git@github.com:marcfrederick/git-foreach.git
cd git-foreach
cargo build --release

Contributing

Contributions are welcome! Please feel free to submit issues and pull requests on the GitHub repository.

License

This project is licensed under the MIT License. See the LICENSE file for details.