If you're a developer juggling between work projects, personal side projects, and maybe even some open-source contributions, you're likely familiar with a common frustration—managing multiple Git identities on the same machine.
Imagine this scenario: You commit changes to your personal project and push them to GitHub, only to realize that your work email is attached to the commit. Or worse, you accidentally push a work-related change using your personal GitHub account. Fixing this means manually updating your Git config each time you switch contexts.
For years, developers have resorted to running:
git config --global user.name "Your Name"
git config --global user.email "your.email@example.com"
But this is tedious and error-prone. What if there was a better way?
Meet gguser
gguser is a simple yet powerful CLI tool designed to seamlessly switch between multiple Git user profiles. Whether you're switching between work, personal, or open-source accounts, gguser makes the process effortless.
🚀 Installing gguser
Installing gguser is quick and easy. Simply run:
npm install -g gguser
Now, you have gguser available globally, ready to manage your Git profiles.
🎯 How to Use gguser
1️⃣ Adding Git Profiles
Before switching between Git users, you need to define them:
gguser add <profile_name> "<full_name>" "<email>" [ssh_key]
Example:
gguser add work "Shubhendra Chauhan" "work@company.com" ~/.ssh/id_ed25520
gguser add personal "Shubhendra Singh Chauhan" "personal@email.com" ~/.ssh/id_ed25521
Here, the SSH key is optional but useful if you want to authenticate using SSH.
2️⃣ Switching Between Git Profiles
Interactive Selection
Instead of remembering profile names, use:
gguser select
You'll see a list of your configured profiles and can simply pick one.
Quick Switching
If you already know which profile you want to switch to, just run:
gguser <profile_name>
Example:
gguser work
This updates your Git global config instantly.
3️⃣ Checking Your Current Git User
Ever wondered which Git identity is active? Quickly verify using:
gguser now
This command will display the currently configured Git user:
👤 Current Git User: Shubhendra Singh Chauhan <personal@email.com>
4️⃣ Managing Your Profiles
Listing All Profiles
To see all configured profiles, run:
gguser list
Removing a Profile
No longer need a profile? Remove it:
gguser remove <profile_name>
🔗 Linking a Profile to a Directory
Many developers work on different projects that require different Git identities. For example:
- Your personal projects live in
~/projects/personal - Your work projects live in
~/projects/work
Instead of manually switching Git users each time, you can link a profile to a specific directory:
gguser link work
Now, whenever you enter that directory, gguser will automatically use the correct Git profile.
To unlink:
gguser unlink
🔥 Why gguser is a Game-Changer
✅ No more accidental commits with the wrong Git identity
✅ Seamlessly switch between work, personal, and open-source profiles
✅ Automatic profile selection based on directories
✅ Easily manage SSH keys
✅ Developer-friendly CLI with an interactive selection mode
💡 Contribute or Extend gguser
gguser is open-source, and contributions are welcome! If you have ideas for improvements or new features, feel free to submit a pull request. You can check out the repo here:
🔗 GitHub: https://github.com/withshubh/gguser
📦 NPM: https://www.npmjs.com/package/gguser
🎯 Final Thoughts
For developers working with multiple Git accounts, gguser is a must-have tool. No more wasting time manually updating Git config settings or dealing with incorrect commit histories. Try it out today and simplify your workflow!
Let me know in the comments how gguser has helped you! 🚀
Top comments (0)