ChatGPT Folder Organizer Overlay

WHAT IT DOES

ChatGPT Folder Organizer Overlay adds a powerful folder management interface to ChatGPT, allowing you to organize your conversations into custom folders. Create, rename, and delete folders directly from the overlay, and drag conversations between folders to keep your chat history tidy. The tool automatically detects your conversations in the sidebar and provides a visual organizer with color-coded folder labels. Folders and their contents are saved locally, so your organization persists across sessions.

WHERE IT RUNS

This extension works exclusively on ChatGPT at chatgpt.com. It functions on the main chat page, including the sidebar conversation list and any page displaying chat history. The tool works across all ChatGPT versions and adapts to the dynamic chat interface.

HOW TO USE

Install the extension and open ChatGPT. A folder organizer appears on the right side of the screen showing your existing folders and their contents. Click "+ New Folder" to create a folder, then enter a name. Add conversations to folders by dragging them from the sidebar or using the "Add to Folder" option. Click the ✏️ button next to any folder to rename it, or the 🗑️ button to delete it. Use the overlay panel to customize the experience: toggle the folder organizer on or off, toggle drag-and-drop support on or off, toggle auto-save on or off, export your folder structure as JSON data, or import a previously exported folder structure. Click "Refresh Folders" to manually re-scan the conversation list.

TECHNICAL SECTION — CONVERSATION DETECTION AND FOLDER MANAGEMENT

The extension uses a multi-strategy detection engine to find conversations in ChatGPT's sidebar. It queries common conversation selectors including .history-item, .conversation-item, and [data-testid="history-item"], extracting conversation IDs and titles. Folder data is stored using GM_setValue as a JSON object mapping folder names to arrays of conversation titles. The organizer interface is created using DOM manipulation with inline CSS and positioned as a fixed overlay. Folder operations (create, rename, delete, add conversation) update the stored data and re-render the interface. The tool also supports drag-and-drop for moving conversations between folders when enabled. All folder data is saved automatically and restored on page load.

THE PANEL — DRAG / PER-SITE POSITION / SNAP / COLLAPSE / RESIZE / ESCAPE

The overlay panel is fully interactive and designed for seamless multitasking. Drag it anywhere on the screen using the handle at the top of the panel; the position is saved per site so it stays where you left it across sessions. The panel includes a snap-to-edge feature that gently anchors the overlay to the nearest screen edge when released. Click the collapse button to minimize the panel to a compact pill showing the current folder status; expand it again with a single click. Resize the panel vertically by dragging the bottom-right corner to view more controls. Press the Escape key at any time to instantly close the overlay; it reappears on the next page navigation or refresh.

PLEASE NOTE

This extension requires the free BotGentz companion extension to function, as it provides the underlying content script injection and cross-origin communication framework. No personal data, browsing history, or conversation content is stored, transmitted, or shared. Folder data is stored locally in your browser using GM_setValue and is never sent to any external server. The extension does not access or store login credentials, financial data, or personally identifiable information. The tool reads conversation titles visible on the page and does not access ChatGPT's API or any private data. ChatGPT may update its page structure; the extension includes multiple detection strategies to maintain compatibility, but major redesigns may temporarily affect conversation detection. The folder organizer is a visual overlay and does not modify ChatGPT's internal data or functionality.