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.