git-iam

Command line tool for easily switching git authors, remotes, and other configs on shared computers.

Installation

$ gem install git-iam

Usage

Run via the command line using the command git iam.

Set user name and remote origin url

$ git iam [USERNAME]

Set user email along with name and remote origin url. (same as command above, optionally accepting an email address)

$ git iam [USERNAME] [EMAIL]

View current user name, email and remote origin url

$ git iam who

Reset to global git config values

$ git iam reset

Looking for a pairing solution?

git-iam works great with git-pair. Easily set up a pair profile with git-pair, and then change config values with git-iam.

Available commands

  • git iam [USERNAME] Set user name and remote origin url.
  • git iam [USERNAME] [EMAIL] Set user email along with name and remote origin url.
  • git iam who View current user name, email and remote origin url.
  • git iam reset Reset to global git config values.
  • git iam user [USERNAME] Set user name.
  • git iam email [EMAIL] Set user email.

Find all available commands

$ git iam

Find details about a command

$ git iam help [COMMAND]

TODO

  • Create pairing module - consider command git iam also [username]
  • Add a remote-only setting option git iam [USERNAME] --remoteonly [REMOTEACOUNT], or git iam remote [REMOTEACOUNT]
  • Create helpers for changing options on remote urls --branch, --remote, etc. (might overlap with previous bullet)
  • Consider integrating git-pair for pairing config.
  • Implement a --force for git iam [username] incase the username conflicts with any reserved keywords.

Contributing

  1. Fork it
  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 new Pull Request