idgit - /ˈɪdʒɪt/ 📇

idgit (pronounced how a cowboy might say 'idiot') is a rolodex for your git config.

Install it with:

/bin/bash -c "export INSTALL_IDGIT=true; $(curl -fsSL https://raw.githubusercontent.com/matthewstrasiotto/idgit/main/idgit.bash)"

Aims

idgit provides a simple, bash only mechanism for setting up alternative git identities for different accounts, and easily swapping between them.

It aims to replace the convenient, but sometimes messy --global user.name/user.email settings, while saving you the effort of typing your entire email (Maybe us millenials are as lazy as they say).

idgit also provides some gentle guard-rails for protecting your privacy.

Usage

• Place a plain-text file with the .alias extension in $XDG_CONFIG/idgit/ (~/.config/idgit by default).
• Place your details in the file as follows:

  # ~/.config/idgit/matthew_github.alias
  # Lines beginning with # are ignored
  # user.name first
  Matthew Strasiotto
  # user.email next
  39424834+matthewstrasiotto@users.noreply.github.com
  # credential.username last (optional)
  matthewstrasiotto 

• When you clone a new repo, before you commit:

  idgit <profile_name>

  Eg

  idgit matthew_github

Installation

From your terminal:

/bin/bash -c "export INSTALL_IDGIT=true; $(curl -fsSL https://raw.githubusercontent.com/matthewstrasiotto/idgit/main/idgit.bash)"

If you prefer to read scripts you run, feel free to download and inspect the linked script.

I will probably make a brew/linuxbrew formula if anyone else uses this.

• idgit installs to ~/.idgit.bash.
• It patches in [[ -f ~/.idgit.bash ]] && source ~/.idgit.bash only if that hasn't already been added.
• TODO: It asks if you want it to warn you about insecure settings.

Stuff it helps with

idgit provides some gentle privacy safeguards:

• 🚨 idgit warns you if you have --global or --system level user.name/user.email set.
• 🚨 idgit warns you if user.useConfigOnly is not true - Meaning git will try to "guess" at your user.name / use.email based on the environment.
• 🚨 idgit warns you if your push remote is github.com, and your email isn't @users.noreply.github.com. See GitHub's Blocking Command Line Pushes that Expose Your Personal Email Address

🚀 idgit tries to be convenient, and comes with tab completion.

Roadmap:

• Probably print applied settings so people can see the correct id is being used
• Implement install script properly
  • Let this be unattended, use env vars for some options.

Similar Works

https://github.com/unixtools/git-identity-helper https://stackoverflow.com/questions/13750953/is-it-possible-to-configure-user-name-and-user-email-per-wildcard-domains-in-gi