# How to use the command 'git for-each-repo' (with examples)

Git for-each-repo is an experimental command that allows you to run a Git command on a list of repositories. It is particularly useful when you need to perform the same action on multiple repositories, saving you time and effort.

Use case 1: Run maintenance on each of a list of repositories stored in the maintenance.repo user configuration variable

Code:

git for-each-repo --config=maintenance.repo maintenance run

Motivation:

Running maintenance tasks on multiple repositories can be a tedious and time-consuming process. With git for-each-repo, you can automate this process by specifying a list of repositories stored in the maintenance.repo user configuration variable, and running the maintenance command on each one of them.

Explanation:

• git for-each-repo: The main command to run a Git command on multiple repositories.
• --config=maintenance.repo: The --config option allows you to specify a user configuration variable containing the list of repositories to perform the command on. In this case, maintenance.repo is the user configuration variable with the list of repositories.
• maintenance run: The actual maintenance command to be run on each repository.

Example output:

Running maintenance on Repository 1...
[maintenance output]

Running maintenance on Repository 2...
[maintenance output]

Running maintenance on Repository 3...
[maintenance output]

Use case 2: Run ‘git pull’ on each repository listed in a global configuration variable

Code:

git for-each-repo --config=global_configuration_variable pull

Motivation:

Keeping your repositories up to date with the latest changes from remote branches is crucial. With git for-each-repo, you can easily maintain consistency across multiple repositories by running git pull on each one of them.

Explanation:

• git for-each-repo: The main command to run a Git command on multiple repositories.
• --config=global_configuration_variable: The --config option allows you to specify a global configuration variable that contains a list of repositories to perform the command on.
• pull: The actual Git command to be run on each repository. In this case, it is git pull, which fetches the latest changes from the remote branch and merges them into the local branch.

Example output:

Pulling changes for Repository 1...
[git pull output]

Pulling changes for Repository 2...
[git pull output]

Pulling changes for Repository 3...
[git pull output]

Conclusion:

The git for-each-repo command is a powerful tool that allows you to automate repetitive tasks across multiple Git repositories. By specifying a list of repositories stored in configuration variables, you can easily run commands such as maintenance tasks or pulling changes on each one of them. This saves you time and effort, making your Git workflow more efficient.