Threadly

Multi-Platform AI Extension

A universal browser extension that enhances major AI chat platforms with a sleek, powerful sidebar for managing, searching, and refining your conversations.

---

📋 Table of Contents

• Overview
• Demo
• Features
• Availability
• Tech Stack
• Project Structure
• Getting Started
• Usage
• Technical Details
• Contributing
• License
• Support

---

🎯 Overview

Threadly is a universal browser extension that transforms your experience on major AI chat platforms like ChatGPT, Claude, and Gemini. It automatically injects a sleek, powerful sidebar to help you manage, search, and navigate your conversations with ease.

With AI-powered prompt refinement and advanced collection management, Threadly helps you write better prompts and organize your conversations effortlessly. All powered by a modern glassmorphic UI with complete privacy through local storage.

---

🎥 Demo

Demo showcasing Threadly's auto-loading sidebar, instant search, and AI prompt refinement features.

---

✨ Features

• Universal Compatibility — Works seamlessly with ChatGPT, Claude, Gemini, Grok, Perplexity, and more
• AI-Powered Prompt Refiner — Automatically enhances your prompts for better AI responses using the Gemini API
• Advanced Collection Management — Organize saved messages into color-coded, searchable collections
• Beautiful Glassmorphism UI — Modern, sleek interface with smooth, physics-based "metaball" animations
• Instant Search & Filtering — Quickly find any message and filter by user, AI, or favorites
• Real-time Message Extraction — Automatically captures and indexes conversations as you chat
• Privacy-Focused — All data, collections, and API keys stored securely on your local device
• Manifest V3 Compliant — Built with the latest Chrome Extension standards for security and performance

---

🌐 Availability

Browser	Status	Link
Google Chrome	✅ Available	Chrome Web Store
Microsoft Edge	🔜 Coming Soon	Edge Add-ons
Opera	🔜 Coming Soon	Opera Addons

Compatible with all major Chromium-based browsers

---

🛠️ Tech Stack

Technology	Description
JavaScript (ES6+)	Core logic for sidebar, UI interactions, data extraction, and API handling
HTML5 / CSS3	Structure and advanced styling for glassmorphism UI and responsive layout
Manifest V3	Latest Chrome Extension APIs for secure service worker-based architecture
Chrome Extension APIs	Uses storage, tabs, and alarms for data persistence and background tasks
Google Gemini API	Powers the intelligent AI Prompt Refinement feature

---

📁 Project Structure

threadly/
└── chrome-extension/
    ├── Borel/                     # Custom font files
    ├── ai-studio-sparkle.js       # Injects 'Refine' button on AI Studio
    ├── api-handler.js             # Handles Gemini API calls for prompt refinement
    ├── background.js              # Service worker for background tasks
    ├── chatgpt-sparkle.js         # Injects 'Refine' button on ChatGPT
    ├── claude-icon.js             # Injects 'Refine' button on Claude
    ├── content.js                 # Main script to inject and manage sidebar
    ├── gemini-sparkle.js          # Injects 'Refine' button on Gemini
    ├── perplexity-sparkle.js      # Injects 'Refine' button on Perplexity
    ├── popup.html                 # Browser action popup UI
    ├── popup.js                   # API key management logic
    ├── prompts.json               # Database of prompts for Triage AI
    ├── sidebar.css                # Complete UI styling
    └── manifest.json              # Extension configuration

Key Files

File	Purpose
manifest.json	Defines permissions, content scripts, and service worker configuration
background.js	Manifest V3 service worker for background tasks and autonomous learning
content.js	Main content script for sidebar rendering and conversation extraction
api-handler.js	PromptRefiner class and Triage AI for Gemini API integration
sidebar.css	Complete stylesheet including glassmorphism and animations

---

🚀 Getting Started

Prerequisites

• Modern Chromium-based browser (Chrome, Edge, or Opera)
• Git (for cloning the repository)
• Google Gemini API Key (free)

Installation

1. Clone the repository

   git clone https://github.com/evinjohnn/Threadly
   cd Threadly

2. Open your browser's extension page

   • Chrome: chrome://extensions
   • Edge: edge://extensions
   • Opera: opera://extensions

3. Enable Developer Mode

   • Toggle the "Developer mode" switch in the top-right corner

4. Load the extension

   • Click "Load unpacked"
   • Select the chrome-extension directory from the cloned repository

5. Done! The extension is now installed and active.

---

💡 Usage

1. Set Your API Key

   • Click the Threadly icon in your browser toolbar
   • Enter your Gemini API key

2. Navigate to a Supported Platform

   • Visit sites like chat.openai.com, claude.ai, or gemini.google.com

3. Use the Sidebar

   • The Threadly sidebar tab appears automatically on the right
   • Click to expand and manage your conversations

4. Refine Your Prompts

   • Type a prompt in the AI platform's input box
   • Click the ✨ Refine button to automatically enhance your prompt

---

🔧 Technical Details

Component	Description
Manifest V3	Modern security and performance standards with service worker architecture
Content Scripts	Platform-specific scripts for UI integration on each AI site
Background Service Worker	Manages autonomous learning and data curation from user feedback
Local Storage	Secure local storage via chrome.storage API for all data
Gemini API Integration	Intelligent prompt classification and refinement

---

🤝 Contributing

We welcome contributions! Here's how you can help:

• 💬 Discussions — Share insights and ask questions on our Reddit community
• 🐛 Report Issues — Submit bugs or feature requests via GitHub Issues
• 💡 Pull Requests — Review open PRs or submit your own

Contribution Guidelines

1. Fork the repository

   git clone https://github.com/YOUR_USERNAME/Threadly

2. Create a new branch

   git checkout -b feature/your-feature-name

3. Make your changes

   • Develop and test locally

4. Commit your changes

   git commit -m "Add: your feature description"

5. Push to GitHub

   git push origin feature/your-feature-name

6. Submit a Pull Request

   • Clearly describe your changes and motivations

---

📄 License

This project is licensed under the MIT License. See the LICENSE file for details.

---

☕ Support the Project

If you find Threadly helpful, consider supporting its development!

---

🙏 Acknowledgments

Special thanks to the open-source community and all users who provide valuable feedback to make Threadly better.

Made with ❤️ for the AI community

---

_{⭐ Star this repo if you find it useful!}