Git Switch (DEPRECATED)

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 -l or --list to list configured profiles

git switch -l

• Use -v or --verbose to print more detailed output

git switch personal -v

The gem is available as open source under the terms of the MIT License.