Manage multiple Git identities
Go
Switch branches/tags
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
cmd/karn
config
repo
vendor
.gitignore
.travis.yml
Gopkg.lock
Gopkg.toml
LICENSE
README.md
karn.go

README.md

Build Status

karn: Manage multiple Git identities with ease

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

Homebrew (OS X)

Install using Homebrew on OS X

brew install karn

Pre-built binary

Head to the releases page to download pre-built binaries for OS X/Linux/Windows.

Go

You can install karn using Go with the following command:

go get github.com/prydonius/karn/cmd/karn

Arch Linux

karn has a AUR package: https://aur.archlinux.org/packages/karn/. You can install it using your AUR helper of choice.

Usage

karn can be used in two ways!

Automatically check for identity updates before running a Git command

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

Run manually when you want to update

Alternatively, you can run karn update manually in a Git repository whenever you need to update your identity for that repository.

Configuring Identities

karn looks for a YAML configuration file in your home directory, ~/.karn.yml.

A sample configuration looks like this:

---
~/Fun:
  name: Adnan Abdulhussein
  email: adnan@prydoni.us
~/Fun/karn:
  name: Sisterhood of Karn
  email: sisterhood@karn.io
/Work:
  name: Adnan A
  email: adnan@bitnami.com

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.