🗨️ Chat Header Generator

For the obsessively organized AI conversationalist

A lightweight Python desktop app for tracking and organizing your AI conversations across multiple platforms with standardized headers and comprehensive metadata.

🎯 Why This Exists

If you're like me and have conversations scattered across ChatGPT, Claude, Cursor, Gemini, and other AI platforms, you know the pain of:

• 📅 Losing track of when important conversations happened
• 🔍 Struggling to find that one conversation where you solved a specific problem
• 📊 Having no systematic way to organize AI-assisted work sessions
• 🔗 Forgetting to save links to valuable conversations before they expire

This tool solves that by giving you one place to track everything with standardized headers and rich metadata.

✨ Features

🚀 Instant Header Generation

Click a button → get a standardized header instantly copied to clipboard:

### 🗨️ Conv-01-20250621-14:38:36‒cursor

🤖 Multi-Platform Support

Track conversations across all major AI platforms:

• GPT-4o / o3 / o3-pro (OpenAI)
• Claude Sonnet 4 (Anthropic)
• Gemini 2.5 (Google)
• Cursor (AI-powered editor)
• Easily extensible for new platforms

📝 Rich Metadata Management

• Chat Names - Manually copy meaningful titles from your AI conversations
• Detailed Summaries - Ask your AI for turn-by-turn summaries, then paste them in
• Direct Links - Copy URLs from your browser to preserve conversation access
• Timestamps - Automatic sequential numbering and timing
• Daily Organization - Separate CSV files for each day

🖥️ Clean Desktop Interface

• One-click header generation with instant clipboard copy
• Double-click editing for detailed conversation metadata
• Live conversation list showing all today's chats
• Copy/Delete management for individual entries
• No external dependencies - just Python standard library

🚀 Quick Start

Prerequisites

• Python 3.6+ (with tkinter support)
• That's it! Zero external dependencies.

Installation

1. Clone the repository:

   git clone https://github.com/DSado88/convo-header.git
   cd convo-header

2. Create virtual environment (optional but recommended):

   python3 -m venv venv
   source venv/bin/activate  # On Windows: venv\Scripts\activate

3. Run the application:

   ./convo_header.sh  # On Unix/macOS
   # OR
   python3 main.py    # Direct execution

📖 Usage

1. Generate Headers

• Click any model button (GPT-4o, Sonnet 4, etc.)
• Header is automatically copied to clipboard
• Paste into your AI chat to start with consistent naming

2. Add Context Later

• Double-click any conversation in the list
• Copy/paste chat names from your AI platform
• Ask your AI for a summary (e.g., "give me a turn-by-turn summary"), then paste it
• Copy the browser URL and paste it in the link field
• Save to preserve metadata for future reference

3. Daily Organization

• Each day gets its own CSV file in the CSVs/ directory
• Conversations are automatically numbered sequentially
• Full conversation history preserved with searchable metadata

4. Export and Search

CSV format makes it easy to:

• Import into spreadsheet applications
• Build custom analytics on your AI usage
• Search across conversation history
• Track productivity patterns

📂 Project Structure

convo-header/
├── main.py              # Main application with Tkinter GUI
├── convo_header.sh      # Launch script with venv activation  
├── CSVs/               # Daily conversation logs (gitignored)
│   ├── 20250621.csv    # Example: June 21, 2025 conversations
│   └── 20250622.csv    # Each day gets its own file
└── venv/               # Python virtual environment (optional)

🔧 Configuration

Adding New AI Models

Edit the MODELS dictionary in main.py:

MODELS = {
    "GPT-4o":     "gpt-4o",
    "Your Model": "your-slug",  # Add new models here
    "Sonnet 4":   "sonnet-4",
}

CSV Fields

Each conversation includes:

• num - Sequential number for the day
• timestamp - HH:MM:SS when header was generated
• model - AI platform used
• header - Full standardized header
• name - Custom conversation title
• summary - Detailed conversation notes
• link - URL to original conversation

🎨 Example Use Cases

🚧 Complex Technical Projects

Track multi-session debugging with turn-by-turn summaries (manually copied from AI):

Name: Backend Crash Fix  [copied from chat title]
Summary: Turn 1: Found AttributeError in /api/v1/documents
         Turn 2: Root cause was await on synchronous method  
         Turn 3: Fixed with asyncio.to_thread() wrapper
         [pasted from: "give me a turn-by-turn summary"]
Link: https://chatgpt.com/c/68570a0a-137c-8001-b6e5  [browser URL]

📚 Learning Sessions

Organize educational conversations by topic:

Name: React Performance Optimization  [from chat title]
Summary: Learned about React.memo, useMemo, useCallback
         Got specific examples for component memoization
         [manually asked AI: "summarize what we covered"]
Link: https://claude.ai/chat/abc123  [copied from browser]

💡 Creative Brainstorming

Keep track of ideation sessions:

Name: Product Feature Ideas  [your own title]
Summary: Explored 5 different approaches to user onboarding
         Settled on progressive disclosure with tooltips
         [asked: "give me a summary of our brainstorm"]
Link: https://gemini.google.com/app/xyz789  [browser URL]

🤝 Contributing

This project is perfect for fellow AI conversation obsessives! Contributions welcome:

• 🐛 Bug reports - Found an issue? Please report it
• ✨ Feature requests - Ideas for better conversation tracking?
• 🔧 Code improvements - PRs welcome for enhancements
• 📖 Documentation - Help make this more accessible

📄 License

MIT License - feel free to fork, modify, and share!

🙏 Acknowledgments

Built for the growing community of AI-assisted developers, researchers, and creators who believe in systematic organization of digital conversations.

---

Happy conversation tracking! 🚀

If this helps you stay organized, consider starring the repo to help others find it.