🚀 IGWAT – Interactive Git Workflow Assistant for Teams

Simplify your team's Git collaboration with a lightweight, terminal-based assistant that helps manage your workflow effortlessly. Whether you're starting new features, reviewing pull requests, or handling branches, this tool guides you through common Git tasks via an intuitive interactive menu — so you can focus on coding, not commands.

---

📚 Table of Contents

• ✨ Features
• 💡 Why IGWAT?
• 📦 Installation
• 🚀 Usage
• 🧹 Uninstalling
• 🤝 Contributing
• 👤 Authors
• 💼 License
• 📘 Acknowledgements

---

✨ Features

• 🔧 Start New Features or Tasks
  Quickly create and switch to new feature branches.

• 🔍 Review & Merge Pull Requests
  Streamline your PR process directly from the terminal.

• 🛠️ Git Utilities
  Run status, pull, and fetch without typing full commands.

• 🌿 Branch Management
  Switch between branches or delete obsolete ones safely.

• 🚪 Clean Exit
  Exit is always the last menu option — to avoid accidental quits.

---

💡 Why IGWAT?

• ⚡ Boost Productivity – No need to memorize Git commands.
• 🤝 Team Friendly – Standardize Git workflows across your team.
• 🧩 Lightweight & Fast – Terminal-based with no heavy dependencies.
• 🔓 Open Source & Customizable – Tailor it to fit your team's workflow.

---

📦 Installation

🔧 Prerequisites

• Ubuntu/Debian-based system
• Git installed
• Install GH CLI
• Bash shell

💻 Manual Installation (Dev Mode)

git clone https://github.com/crispusomollo/gitcollab

cd gitcollab

sudo ./install.sh

or:

sudo make install

📥 Install using .deb package (Recommended)

# Download the package
wget https://github.com/crispusomollo/gitcollab/blob/main/gitcollab-deb.deb

# Install the package
sudo dpkg -i gitcollab-deb.deb

---

🚀 Usage

Navigate to any Git project folder, then run:

gitmenu

You will see a menu:

==============================
🚀 GIT COLLABORATION MENU
==============================
1. Start New Feature / Task
2. Review & Merge Pull Requests
3. Git Utilities (status, pull, fetch)
4. Branch Management (switch/delete)
5. Exit
------------------------------
👉 Choose an option [1-5]:

🔧 Commands

Command	Description
gitmenu	Launch the interactive menu
gitcollab	Start a feature/task + open draft PR
gitreview	Checkout PRs, test, and squash merge

---

🧹 Uninstalling

To fully remove the IGWAT collaboration tools:

# 1. Download and run the uninstall script
wget https://github.com/crispusomollo/gitcollab/blob/main/uninstall.sh

# 2. Make the script executable
chmod +x uninstall.sh

# 3. Run the script
./uninstall.sh

---

🤝 Contributing

Want to add a feature? Fix a bug? Create a PR! Contributions, issues, and feature requests are welcome!

1. Fork the repository
2. Create your feature branch

   git checkout -b feature/your-feature

3. Commit your changes

   git commit -m 'Add your feature'

4. Push to the branch

   git push origin feature/your-feature
   

5. Open a Pull Request

Please ensure your code follows existing style and includes tests if applicable.

---

👤 Authors

• Crispus M. Omollo

💼 License

MIT License

📘 Acknowledgements

• ALX Africa
• Fred Swaniker
• How to write a Good readme
• ChatGPT