Git Switch is now Git Swap. Due to git releasing a native switch command, the gem has been renamed.
Git Switch is a command line utility to easily switch between multiple git profiles. It uses a .gitswitch YAML file to configure each profile (name, username, and email) and ssh key.
This gem has been developed for, and only tested on, Mac OS.
Additionally, it requires git version 2.10+. Run git --version to check your currently install version. If you are using homebrew, you can install a newer version of git with brew upgrade git.
This gem is not intended to be installed via a Gemfile. Instead, install it yourself:
$ gem install git_switch
If you use rvm, you can save yourself from some headaches by installing git_switch for all gemsets.
$ rvm @global do gem install git_switch
To run the guided setup, use git switch --config.
You may also manually create or edit your configuration at ~/.gitswitch. The config file is in YAML format. Here is an example.
personal:
username: johnnyfive
email: me@johnsmith.com
name: Johnny Smith
ssh: ~/.ssh/id_rsa
work:
username: johnsmith
email: john@defmethod.io
name: John Smith
ssh: ~/.ssh/defmethod_rsa
Note that the ssh key must already exist. See these instructions to generate a new SSH key.
The root keys can be any nickname you want. It should be memorable to make it easy to switch between profiles.
Git Switch follows the convention to create a custom git command. It can be invoked as follows, to either set your git profile locally (no flag) or globally (-g):
$ git switch personal
$ git switch personal -g
Note that currently, invoking git switch will remove all identities from ssh-add, except the one specified. You can always readd them using ssh-add path/to/ssh.
- Use
-lor--listto list configured profiles
git switch -l
- Use
-vor--verboseto print more detailed output
git switch personal -v
The gem is available as open source under the terms of the MIT License.