Git-Switch

A utility to switch between different .gitconfig files.

This utility is based on and borrows much of the underlying code from NPMRC, which does the same thing but for .npmrc files.

Overview

If you've ever had to work in various environments with different proxy settings, or you have different github accounts for different projects, it can be a pain to constantly adjust your .gitconfig file manually. This utility allows you to maintain multiple named versions of your .gitconfig file and switch between them seamlessly with a simple terminal command. It also tries to protect you from yourself by making sure you don't accidentally overwrite a .gitconfig file that you actually want to keep.

Installation

npm install -g @joebochill/git-switch

Usage

gitswitch --help

gitswitch

  A utility to switch between different .gitconfig files.

Usage:
  gitswitch                 list all profiles
  gitswitch [name]          change gitconfig profile (uses fuzzy matching)
  gitswitch -c [name]       create a new gitconfig profile called name

Initialisation

Calling gitswitch without arguments creates an ~/.gitconfigs/ directory if it doesn't exist, and copies your current ~/.gitconfig as the 'default' .gitconfig profile.

gitswitch
Creating /Users/joe/.gitconfigs
Making /Users/joe/.gitconfig the default gitconfig file
Activating .gitconfig 'default'

Create a new .gitconfig profile

gitswitch -c newprofile
Removing old .gitconfig (/home/joe/.gitconfigs/default)
Activating .gitconfig 'newprofile'

A blank profile will be created.

List available .gitconfig profiles

gitswitch 
Available gitconfigs:
    
* default
  work

Switch to a specific .gitconfig

gitswitch work
Removing old .gitconfig (/Users/joe/.gitconfigs/default)
Activating .gitconfig 'work'

You can also pass only the first few characters of a profile and gitswitch will autocomplete the profile's name.

gitswitch def
Removing old .gitconfig (/Users/joe/.gitconfigs/work)
Activating .gitconfig 'default'

gitswitch <name> will also go to some lengths to make sure you don't overwrite anything you might care about:

gitswitch default
Removing old .gitconfig (/Users/joe/.gitconfigs/work)
Activating .gitconfig 'default'
gitswitch default  
Current .gitconfig (/Users/joe/.gitconfig) is already 'default' (/Users/joe/.gitconfigs/default)
rm ~/.gitconfigs
touch ~/.gitconfigs
gitswitch default
Current .gitconfig (/Users/joe/.gitconfigs) is not a regular file, not removing it
rm ~/.gitconfigs
gitswitch default
Activating .gitconfig 'default'

Note For Windows Users: You may have to run gitswitch in a shell (cmd, PowerShell, Git Bash, etc) with elevated (Administrative) privileges to get it to run.

Environment Variables

• GITSWITCH_STORE - Path to directory of profiles. Default: ~/.gitconfigs/
• GITSWITCH - Path to the gitconfig file used by git. Default: ~/.gitconfig

License

MIT. A copy is included with the source.