gguser

gguser is a CLI tool to easily switch between different Git user profiles. It simplifies managing multiple GitHub or GitLab accounts by allowing users to switch between profiles effortlessly.

🚀 Installation

Install gguser globally using npm:

npm install -g gguser

🎯 Usage

Commands Overview

Command	Description
gguser add <profile_name> "<full_name>" "<email>" [ssh_key]	Adds a new Git profile with an optional SSH key
gguser select	Opens an interactive menu to switch profiles
gguser <profile_name>	Switches directly to a specified Git profile
gguser now	Displays the currently configured Git user
gguser list	Lists all available Git profiles
gguser remove <profile_name>	Removes a specified Git profile
gguser link <profile_name>	Links a Git profile to a specific directory
gguser unlink	Removes a profile link from the current directory

1️⃣ Add a new Git profile

gguser add <profile_name> "<full_name>" "<email>" [ssh_key]

Note: ssh_key is optional

Example:

gguser add work "Shubhendra Chauhan" "work@company" ~/.ssh/id_ed25520
gguser add personal "Shubhendra Singh Chauhan" "personalemail@gmail.com" ~/.ssh/id_ed25520

2️⃣ Switch to a Git profile

gguser select

Or switch directly:

gguser <profile_name>

3️⃣ Show the current Git user

gguser now

4️⃣ List all profiles

gguser list

5️⃣ Remove a profile

gguser remove <profile_name>

6️⃣ Link a profile to a directory

gguser link <profile_name>

This ensures that whenever you're inside that directory, the correct Git user is applied.

7️⃣ Unlink a directory

gguser unlink

📝 License

This project is licensed under the Apache License 2.0 - see the LICENSE file for details.

🎯 Contributing

We welcome contributions from the community! Follow these steps to contribute:

1. Fork the repository on GitHub.
2. Create a feature branch (git checkout -b feature-new)
3. Commit your changes (git commit -m "Added a new feature")
4. Push to GitHub (git push origin feature-new)
5. Create a Pull Request 🚀

📬 Support

If you find an issue or want a new feature, create an issue here.