git-identity

A CLI tool for managing git identity profiles. Quickly switch between different git identities (name, email, signing key) on a per-repository basis.

Installation

cargo install --path .

Usage

Use git-indentity command as it is or add a git alias!

[alias]
  identity = !git-identity

List available identities

git-identity list

# or with git alias
git identity list

Output:

Available git identities:
- personal
* work

The * indicates the currently active identity for the repository.

Use -v for verbose output with full details:

git-identity list -v

Set an identity

git-identity set work

This applies the identity to the current repository's local git config.

Configuration

Create a profiles file at ~/.git-identities/profiles:

[identity "personal"]
    name = Your Name
    email = you@personal.com

[identity "work"]
    name = Your Name
    email = you@company.com
    signingkey = ABC123

Profile options

How it works

• git-identity list reads profiles from ~/.git-identities/profiles and displays them. It also checks the current repository's git config to show which identity is active.

• git-identity set <name> finds the matching profile and writes user.name, user.email, and optionally user.signingkey to the current repository's local .git/config.

Contributing

Contributions are welcome! The codebase is documented with rustdoc comments. Run cargo doc --open to browse the documentation.

Project structure

src/
  main.rs      # CLI entry point and argument parsing
  identity.rs  # Core identity management logic
  error.rs     # Error types

License

MIT

Thanks

Big thanks to Micah for the inspiration for this project. See Micah's blog post for Setting Up Git Identities.