🚀 Smart Tab Auto-Grouper

Automatically organize your browser tabs into smart groups for a cleaner, more productive browsing experience.

---

📋 Table of Contents

• Overview
• Features
• Installation
• Getting Started

---

🎯 Overview

Smart Tab Auto-Grouper is a powerful browser extension that automatically organizes your tabs into meaningful groups. Say goodbye to tab chaos and hello to organized browsing! The extension intelligently groups your Gmail tabs, AI service tabs, and can even organize other websites by domain.

Why Use Smart Tab Auto-Grouper?

• 🧹 Reduce Tab Clutter: Automatically organize tabs as you browse
• ⚡ Boost Productivity: Find tabs faster with smart grouping
• 🤖 AI-Aware: Recognizes 100+ popular AI services
• 🎨 Beautiful Interface: Modern, intuitive popup design
• 🔧 Customizable: Adjust settings to match your workflow

---

✨ Features

🎯 Smart Grouping

• Gmail Integration: Automatically groups Gmail and Google Workspace tabs
• AI Services Recognition: Supports 100+ AI platforms including ChatGPT, Claude, Gemini, Perplexity, and more
• Real-time Processing: Groups tabs as you open them

🌐 Domain Grouping

• Automatic Domain Detection: Groups tabs from the same website
• Customizable Thresholds: Set minimum tab count for group creation
• Subdomain Merging: Option to group related subdomains together
• Pinned Tab Exclusion: Keep pinned tabs ungrouped if desired

🎨 Modern Interface

• Live Tab Counts: See how many tabs are in each group
• Animated Interactions: Smooth transitions and micro-animations
• Dark Mode Ready: Adapts to your browser's theme
• Responsive Design: Works perfectly on any screen size

⚙️ Advanced Controls

• Manual Processing: Force-process all open tabs
• Group Refresh: Sync with existing tab groups
• Persistent Settings: Remembers your preferences
• One-Click Toggle: Enable/disable with a single click

---

📦 Installation

Prerequisites

• Browser: Brave, Chrome, Edge, or any Chromium-based browser
• Version: Latest browser version recommended
• Permissions: Allow extensions in developer mode

Step-by-Step Installation

1. Download the Extension

• Clone the repository:

git clone https://github.com/ZvonkoNS/smart-tab-grouper.git

• Or download as ZIP and extract

2. Prepare Your Browser

• Navigate to brave://extensions/ or chrome://extensions/
• Enable Developer Mode using the toggle in the top-right corner

3. Load the Extension

• Click "Load unpacked"
• Navigate to your extracted smart-tab-grouper folder
• Select the folder and click "Open" or "Select Folder"

4. Pin the Extension (Recommended)

• Click the puzzle piece 🧩 icon in your browser toolbar
• Find "Smart Tab Auto-Grouper"
• Click the pin 📌 icon to keep it visible

Verification

✅ The Smart Tab Auto-Grouper icon appears in your toolbar
✅ Clicking it opens the popup interface
✅ Extension status shows "Enabled"

---

🚀 Getting Started

Quick Setup (2 minutes)

• Install the extension
• Open test tabs (Gmail, AI services, same-site tabs)
• Tabs should group automatically

---

📞 Support & Contact

• 🐛 Issues: GitHub Issues
• 💬 Discussions: GitHub Discussions
• 📧 Email: [email protected]

---

⭐ Support This Project

If you find this extension helpful, please consider giving it a star on GitHub!

Made with ❤️ by Zvonimir