Setup your Git repositories to always use a specific identity based on the directory tree.
With karn, you never have to manually change the local repository configuration to a different identity from your global.
karn will change your repository's local user.name and user.email configuration if necessary, but will never modify your global configuration.
Install using Homebrew on OS X
brew install karn
Head to the releases page to download pre-built binaries for OS X. Note that karn is currently only tested on OS X.
You can install karn using Go with the following command:
go get github.com/prydonius/karn/cmd/karn
karn can be used in two ways!
Note: this method overrides the git
command with a function that runs karn update
before executing the original Git command.
Run karn init
to see exactly what the git
command is overriden with
If you're okay with the scary warnings above, add the following line to your shell startup script (e.g. .bash_profile, .zshrc)
if which karn > /dev/null; then eval "$(karn init)"; fi
Alternatively, you can run karn update
manually in a Git repository whenever you need to update your identity for that repository.
karn looks for a YAML configuration file in your home directory, ~/.karn.yml
.
A sample configuration looks like this:
---
~/Fun:
name: Adnan Abdulhussein
email: [email protected]
~/Fun/karn:
name: Sisterhood of Karn
email: [email protected]
/Work:
name: Adnan A
email: [email protected]
In a given repo, karn will try to match with the deepest configured directory. For the configuration above, any repo under the ~/Fun
directory will match the first identity, with the exception of ~/Fun/karn
which matches the second identity. If an identity isn't found, the repo is left untouched.