ChatLift AI Conversation Exporter & Archive
Import, search, and archive AI conversations from ChatGPT, Claude, and Gemini. Clean indexed formats, full-text search, static HTML archive. No server required.
Import, search, and archive your AI conversations.
Extract ChatGPT, Claude, and Gemini conversation exports into clean, indexed formats. Full-text search. Static HTML archive with search bar. No server required.
What It Does
ChatLift converts AI conversation exports into portable, searchable formats:
- Import - Parse ChatGPT/Claude/Gemini exports
- Convert - Generate Markdown, HTML, and JSON
- Search - Full-text search across all conversations
- Archive - Static HTML archive with navigation
Why This Exists
AI chat platforms:
- Lock your conversations in proprietary formats
- Make search difficult or impossible
- Can delete your data at any time
ChatLift gives you control:
- Own your conversation history
- Search across all platforms
- Portable formats (Markdown, HTML, JSON)
- Works offline forever
Quick Start
Install
No dependencies! Python 3.7+ stdlib only.
# Copy config (optional)
cp config_example.py config.py
Import Conversations
Export your conversations from ChatGPT, Claude, or Gemini, then:
# Import ChatGPT export
python3 chat_lift.py chatgpt conversations.json
# Import Claude export
python3 chat_lift.py claude claude-export.json
# Import Gemini export
python3 chat_lift.py gemini gemini-conversations.json
Generates:
chat-archive/markdown/*.md- Human-readable markdownchat-archive/html/*.html- Styled HTML pageschat-archive/json/*.json- Structured JSON
Search Conversations
# Search all conversations
python3 chat_search.py search --query "machine learning"
# Search with regex
python3 chat_search.py search --query "python.*async" --regex
# Search by date range
python3 chat_search.py date --start-date 2026-01-01 --end-date 2026-02-01
# Get archive statistics
python3 chat_search.py stats
Generate HTML Archive
# Generate static archive website
python3 chat_archive.py
# Open chat-archive/web/index.html in browser
The HTML archive includes:
- Search bar - Filter by keyword or source
- Navigation - Browse all conversations
- No server needed - Pure static files
Usage Examples
Import Multiple Exports
# Import all your platforms
python3 chat_lift.py chatgpt chatgpt-export.json
python3 chat_lift.py claude claude-export.json
python3 chat_lift.py gemini gemini-export.json
# Generate unified archive
python3 chat_archive.py
Search Across All Platforms
from chat_search import ConversationSearcher
searcher = ConversationSearcher('chat-archive')
# Find all conversations mentioning "agent"
results = searcher.search('agent')
for result in results:
print(f"{result['conversation']['title']}")
print(f" Source: {result['conversation']['source']}")
print(f" Matches: {result['total_matches']}\n")
Custom Output Formats
# Only generate markdown
python3 chat_lift.py chatgpt export.json --formats markdown
# Generate all formats
python3 chat_lift.py chatgpt export.json --formats markdown html json
# Custom output directory
python3 chat_lift.py chatgpt export.json --output-dir ~/my-chats
Filter Search Results
# Search only ChatGPT conversations
python3 chat_search.py search --query "python" --source chatgpt
# Search only user messages
python3 chat_search.py search --query "explain" --role user
# Case-sensitive search
python3 chat_search.py search --query "API" --case-sensitive
Export Instructions
ChatGPT
- Go to chat.openai.com
- Settings → Data controls → Export data
- Wait for email with download link
- Download
conversations.json
Claude
- Go to claude.ai
- Settings → Privacy → Export your data
- Download export file
- Extract JSON from archive
Gemini
- Go to gemini.google.com
- Account settings → Download your data
- Select Gemini conversations
- Download export file
File Formats
Markdown
# Conversation Title
**Source:** chatgpt
**ID:** abc123def456
**Created:** 2026-02-21 10:30:00
---
## USER
How do I deploy a Flask app?
*2026-02-21 10:30:15*
---
## ASSISTANT
Here's how to deploy a Flask application...
*2026-02-21 10:30:45*
---
JSON
{
"id": "abc123def456",
"title": "Conversation Title",
"source": "chatgpt",
"create_time": 1708512600,
"messages": [
{
"role": "user",
"content": "How do I deploy a Flask app?",
"timestamp": 1708512615
},
{
"role": "assistant",
"content": "Here's how to deploy a Flask application...",
"timestamp": 1708512645
}
]
}
HTML
Clean, styled HTML with:
- Responsive design
- Color-coded messages
- Timestamps
- Source badges
Archive Structure
chat-archive/
├── markdown/ # Human-readable markdown
│ ├── abc123.md
│ └── def456.md
├── html/ # Styled HTML pages
│ ├── abc123.html
│ └── def456.html
├── json/ # Structured JSON
│ ├── abc123.json
│ └── def456.json
└── web/ # Static HTML archive
├── index.html # Browse/search interface
├── abc123.html # Conversation pages
├── def456.html
├── style.css # Styling
└── search.js # Search functionality
Search Features
Full-Text Search
# Simple text search
python3 chat_search.py search --query "machine learning"
# Case-sensitive
python3 chat_search.py search --query "API" --case-sensitive
# Regex patterns
python3 chat_search.py search --query "python.*async" --regex
Filters
# Filter by source platform
python3 chat_search.py search --query "code" --source chatgpt
# Filter by message role
python3 chat_search.py search --query "explain" --role assistant
# Combine filters
python3 chat_search.py search --query "deploy" --source claude --role user
Date Range
# Conversations from specific date range
python3 chat_search.py date --start-date 2026-01-01 --end-date 2026-02-01
# All conversations after date
python3 chat_search.py date --start-date 2026-02-01
# All conversations before date
python3 chat_search.py date --end-date 2026-02-01
Statistics
python3 chat_search.py stats
Shows:
- Total conversations
- Total messages
- Word count
- Breakdown by source
- Breakdown by role
HTML Archive
Features
- Search bar - Real-time filter as you type
- Source filter - Filter by ChatGPT, Claude, Gemini
- Clean design - Responsive, mobile-friendly
- No server - Pure static HTML/CSS/JS
- Works offline - Archive travels with you
Customization
Edit chat-archive/web/style.css to customize:
- Colors
- Fonts
- Layout
- Message styling
The archive is pure HTML/CSS/JS - modify freely.
Integration
Python API
from chat_lift import ConversationImporter
from chat_search import ConversationSearcher
from chat_archive import ArchiveGenerator
# Import conversations
importer = ConversationImporter('chat-archive')
conversations = importer.import_chatgpt('export.json')
for conv in conversations:
importer.save_conversation(conv, formats=['markdown', 'json'])
# Search
searcher = ConversationSearcher('chat-archive')
results = searcher.search('python programming')
# Generate HTML archive
generator = ArchiveGenerator('chat-archive')
generator.generate_archive()
Batch Processing
import glob
from chat_lift import ConversationImporter
importer = ConversationImporter('chat-archive')
# Import all ChatGPT exports in directory
for export_file in glob.glob('exports/chatgpt-*.json'):
conversations = importer.import_chatgpt(export_file)
for conv in conversations:
importer.save_conversation(conv)
print("All exports imported!")
Limitations
See LIMITATIONS.md for details.
Key constraints:
- Export formats vary by platform version
- No real-time sync (manual export/import)
- Search is text-based (not semantic)
- Large archives (10,000+ conversations) may be slow
License
MIT License - See LICENSE
Author: Shadow Rose
Why This Exists
Your AI conversations are valuable:
- Learning history
- Project documentation
- Personal knowledge base
But they're locked in proprietary platforms that:
- Can change or delete your data
- Make search difficult
- Don't export cleanly
ChatLift gives you:
- Ownership - Your data, your formats
- Portability - Markdown, HTML, JSON
- Search - Find anything instantly
- Permanence - Works offline forever
Take back your conversation history.
⚠️ Disclaimer
This software is provided "AS IS", without warranty of any kind, express or implied.
USE AT YOUR OWN RISK.
- The author(s) are NOT liable for any damages, losses, or consequences arising from the use or misuse of this software — including but not limited to financial loss, data loss, security breaches, business interruption, or any indirect/consequential damages.
- This software does NOT constitute financial, legal, trading, or professional advice.
- Users are solely responsible for evaluating whether this software is suitable for their use case, environment, and risk tolerance.
- No guarantee is made regarding accuracy, reliability, completeness, or fitness for any particular purpose.
- The author(s) are not responsible for how third parties use, modify, or distribute this software after purchase.
By downloading, installing, or using this software, you acknowledge that you have read this disclaimer and agree to use the software entirely at your own risk.
DATA DISCLAIMER: This software processes and stores data locally on your system. The author(s) are not responsible for data loss, corruption, or unauthorized access resulting from software bugs, system failures, or user error. Always maintain independent backups of important data. This software does not transmit data externally unless explicitly configured by the user.
Support & Links
| 🐛 Bug Reports | TheShadowyRose@proton.me |
| ☕ Ko-fi | ko-fi.com/theshadowrose |
| 🛒 Gumroad | shadowyrose.gumroad.com |
| @TheShadowyRose | |
| 🐙 GitHub | github.com/TheShadowRose |
| 🧠 PromptBase | promptbase.com/profile/shadowrose |
Built with OpenClaw — thank you for making this possible.
🛠️ Need something custom? Custom OpenClaw agents & skills starting at $500. If you can describe it, I can build it. → Hire me on Fiverr