# **Gitrello – Trello-Powered Git Versioning for VS Code**

## **Overview**  
Gitrello is a **VS Code extension** that seamlessly integrates **Trello task management** with **Git version control**. It helps developers keep their commits aligned with their Trello workflow, ensuring that every code change corresponds to a task in Trello.  

With Gitrello, you can **automate commit messages, track progress directly from VS Code, and streamline task management** without leaving your development environment.  

---

## **Key Features**  

### 🔹 **Trello Task Synchronization**  
- View Trello boards, lists, and cards within VS Code.  
- Assign yourself tasks and update their statuses from the editor.  
- Filter tasks by board, list, or label.  

### 🔹 **Git Commit Automation**  
- Automatically **suggest commit messages** based on active Trello tasks.  
- Include **Trello card IDs and descriptions** in commit messages.  
- Supports **custom commit message templates** for structured versioning.  

### 🔹 **Branch Management & Task Linking**  
- Create Git branches directly from a Trello task.  
- Automatically **link branches to tasks** for easy tracking.  
- Detect and **update task status** when merging branches.  

### 🔹 **Status Updates & Notifications**  
- Notify Trello when a commit is pushed.  
- Auto-move Trello cards to **"In Progress"** or **"Done"** based on commits.  
- Receive **VS Code notifications** when assigned new tasks.  

### 🔹 **Seamless Workflow & Customization**  
- Supports **Trello API authentication** for secure access.  
- Customizable **commit message formats**.  
- Works with **GitHub, GitLab, and Bitbucket repositories**.  

---

## **Use Cases**  

✔ **Solo Developers** – Stay organized by linking your commits to Trello tasks effortlessly.  
✔ **Agile Teams** – Keep your team’s workflow structured by automatically updating Trello boards.  
✔ **Project Managers** – Gain visibility into development progress without switching apps.  

---

## **Installation & Setup**  
1. Install **Gitrello** from the VS Code Marketplace.  
2. Authenticate with your **Trello API key & token**.  
3. Link your **Git repository** and select a Trello board.  
4. Start coding and let **Gitrello automate your commit history!**  

---

## **Why Gitrello?**  
🚀 **Boost Productivity** – Focus on coding while Gitrello handles task tracking.  
🔄 **Improve Workflow** – Keep Git and Trello in sync effortlessly.  
🔍 **Enhance Visibility** – Make project progress clear for your team.