https://github.com/marcfrederick/git-foreach
Lightweight utility designed to execute a command in each Git repository within a directory and its subdirectories
https://github.com/marcfrederick/git-foreach
bash git git-commands shell
Last synced: about 1 month ago
JSON representation
Lightweight utility designed to execute a command in each Git repository within a directory and its subdirectories
- Host: GitHub
- URL: https://github.com/marcfrederick/git-foreach
- Owner: marcfrederick
- License: apache-2.0
- Created: 2024-06-04T18:06:33.000Z (11 months ago)
- Default Branch: main
- Last Pushed: 2025-03-18T19:06:03.000Z (about 1 month ago)
- Last Synced: 2025-03-18T20:22:14.547Z (about 1 month ago)
- Topics: bash, git, git-commands, shell
- Language: Rust
- Homepage:
- Size: 70.3 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE-APACHE
Awesome Lists containing this project
README
# 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.
```shell
git-foreach
```
For instance, if you want to execute git pull in each repository, you would use:
```shell
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.
```shell
git-foreach "git pull || :"
```
## Installation
Pre-built binaries are available for Windows, Linux, and macOS. You can download them from
the [releases page](https://github.com/marcfrederick/git-foreach/releases) and add them to your `$PATH`. The release
page also includes instructions for installation using [Homebrew](https://brew.sh), `curl`, or PowerShell.
### Homebrew
If you're using macOS or Linux, you can install `git-foreach` using [Homebrew](https://brew.sh):
```shell
brew install marcfrederick/homebrew-tap/git-foreach
```
## Building from Source
To build the utility from source, ensure you have [Rust](https://www.rust-lang.org) installed on your system. Then,
execute the following commands:
```shell
git clone [email protected]: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](https://github.com/marcfrederick/git-foreach).
## License
This project is licensed under the MIT License. See
the [LICENSE](https://github.com/marcfrederick/git-foreach/blob/main/LICENSE) file for details.