Sha256: 753a4112ed83e57eeb1f8de61705bf94bda6038fbe70eaa1e8a6323e685e3d51

Contents?: true

Size: 1.94 KB

Versions: 32

Compression:

Stored size: 1.94 KB

Contents

# `git-multi`

## Summary

Execute the same `git` command in a set of related repos.

There are plenty of other utilities out there that do something similar, but typically they only support a limited number of hard-coded `git` commands which can be executed in multiple repositories.

`git-multi` is different: any `git` command _(including any `git` extensions you may have installed or any `git` aliases you may have defined)_ can be executed in multiple repositories.

`git-multi` only concerns itself with iterating over the set of related repos; what it executes in each of them is completely up to you.

## Features

* execute any `git` command, extension and alias in multiple repositories _(not just a limited set of pre-packaged commands)_
* human-friendly output in interactive mode _(akin to [git porcelain][p-p] commands)_, for every day use
* machine parseable output in non-interactive mode _(akin to [git plumbing][p-p] commands)_, for advanced scripting and automation

[p-p]:    https://git-scm.com/book/en/v2/Git-Internals-Plumbing-and-Porcelain

## Prerequisites

`git-multi` is a Ruby script, so you will have to have Ruby installed on your system _(system Ruby, [RVM][], [rbenv][], etc)_.

`git-multi` is also tightly coupled to your [GitHub][] account _(via the github API)_, so you will also need to generate a so-called [personal access token][token] and install it in your git config _(instructions provided below)_.

[rvm]:    https://rvm.io
[rbenv]:  http://rbenv.org
[github]: https://github.com
[token]:  https://github.com/settings/tokens

## Installation

    $ gem install git-multi

## Usage

    $ git multi --help

## Known Issues

1. it probably doesn't work on Windows

## Contributing

1. Fork it ( https://github.com/pvdb/git-multi/fork )
2. Create your feature branch (`git checkout -b my-new-feature`)
3. Commit your changes (`git commit -am 'Add some feature'`)
4. Push to the branch (`git push origin my-new-feature`)
5. Create a new Pull Request

Version data entries

32 entries across 32 versions & 1 rubygems

Version Path
git-multi-5.0.0 README.md
git-multi-4.0.1 README.md
git-multi-4.0.0 README.md
git-multi-3.0.3 README.md
git-multi-3.0.2 README.md
git-multi-3.0.0 README.md
git-multi-2.10.0 README.md
git-multi-2.9.0 README.md
git-multi-2.8.0 README.md
git-multi-2.7.0 README.md
git-multi-2.6.1 README.md
git-multi-2.6.0 README.md
git-multi-2.5.0 README.md
git-multi-2.4.0 README.md
git-multi-2.3.0 README.md
git-multi-2.2.0 README.md
git-multi-2.1.0 README.md
git-multi-2.0.0 README.md
git-multi-1.2.1 README.md
git-multi-1.2.0 README.md