ChatGPT Timeline Extension

🇨🇳 查看中文版：README.zh_CN.md

Interactive timeline for AI conversations (ChatGPT, Gemini, Claude, DeepSeek, Doubao, Grok) - click to navigate, drag to reposition, adapts to themes.

Built with Codex

This project was developed entirely with OpenAI Codex.

Special thanks to Codex for helping build this project.

✅ Supported Platforms

• ChatGPT
• Gemini
• Claude
• DeepSeek
• Doubao
• Grok

✨ Features

• 📍 Clickable markers for instant navigation to any message
• 🧭 Quick jump to conversation points with visual timeline
• 🌐 Multi-platform - optimized for ChatGPT, Gemini, Claude, DeepSeek, Doubao, and Grok
• 🌗 Theme adaptive - matches light/dark modes on supported platforms
• ⚙️ Customizable position and behavior settings
• 📋 Table of Contents sidebar with message index
• 🖱️ Draggable interface for flexible placement
• 📏 Dialog width adjustment - Per-platform width controls for ChatGPT/Gemini/Claude/Grok (20-150rem) and DeepSeek/Doubao (padding-based 0-60rem)
• 📐 Responsive positioning - TOC panel adapts to window resizing using percentage-based coordinates

---

🧩 Installation

Install from Chrome Web Store

Works with supported AI conversation pages (ChatGPT, Gemini, Claude, DeepSeek, Doubao, Grok). Timeline appears automatically after installation.

⚙️ Settings

Click the extension icon in your browser toolbar to access the settings panel:

Timeline Position

• Right (default) - Traditional sidebar position
• Left - Alternative sidebar position
• Top - Horizontal bar at the top
• Bottom - Horizontal bar at the bottom

Draggable Interface

• Enable dragging - Allow moving the timeline to any position
• Auto-save position - Remembers your preferred location

Table of Contents Navigation

• Enable TOC - Shows a sidebar with numbered message index
• Width - Adjust TOC panel width (200-400px)
• Position - Choose left or right side placement

Dialog Width (per platform)

• Dialog Width - Adjust the maximum content width for ChatGPT/Gemini/Claude/Grok (20-150rem) and DeepSeek/Doubao (padding-based 0-60rem)
• Default - 48rem for optimal reading experience
• Real-time adjustment - Drag the slider for instant visual feedback

Long Press Drag Feature

• Long press TOC card - Long press (500ms) on the TOC panel to drag and move position
• Auto-save position - New position is automatically saved to browser local storage
• Boundary constraints - Drag is automatically constrained within screen boundaries
• Visual feedback - Green border appears during long press, rotation and shadow effects during drag

All settings are automatically saved and restored on page reload.

---

📄 License

This project is open-sourced under the MIT License.