pip install mempalace then mempalace init ~/your-project. If you have not done that yet, the Setup Guide covers it in detail.
What You Will Need
To complete this guide you need: MemPalace installed, a palace initialised (the mempalace init step creates your palace structure), and access to your AI conversation exports. The export process is slightly different for each platform, but takes under five minutes in each case.
The Five Supported Conversation Formats
MemPalace's conversation miner (convo_miner.py) automatically detects and normalises five different export formats into a consistent internal transcript structure before ingestion:
| Platform | Export Format | Typical File Name |
|---|---|---|
| ChatGPT | JSON array of conversation objects | conversations.json |
| Claude.ai | JSON project export | project export filename |
| Claude Code | JSONL session files (automatic) | ~/.claude/projects/ |
| Slack | JSON per-channel export | channel name + date |
| Plain text | Speaker-labelled transcript (You: / Claude:) | any .txt file |
Exporting Your ChatGPT Conversation History
- Sign into ChatGPT and click your profile picture in the top-right corner
- Select Settings from the dropdown menu
- Navigate to the Data Controls tab
- Click Export data, then confirm by clicking Confirm export
- ChatGPT sends a download link to your account email — usually within a few minutes
- Download and unzip the archive. Your conversation data is in
conversations.json. - Move the file to a dedicated folder, for example
~/chats/chatgpt/conversations.json
conversations.json may contain hundreds or thousands of conversations concatenated into a single file. Run mempalace split on it before mining (covered below) so each session is processed separately, which improves mining accuracy.
Exporting Your Claude Conversation History
Claude.ai Projects
- Open Claude.ai and navigate to the project you want to export
- Look for an Export or Download option in the project menu or settings panel
- Download the resulting JSON file and place it in
~/chats/claude/
Claude Code Sessions
Claude Code saves sessions automatically to ~/.claude/projects/ as JSONL files. No manual export is required — you can mine directly from that directory:
mempalace mine ~/.claude/projects/ --mode convosSplitting Large or Concatenated Export Files
Some platforms — and some export tools — combine multiple conversation sessions into a single large file. MemPalace's split command breaks these into individual per-session files, which produces cleaner room assignments during mining:
# Check what the splitter would do without changing any files mempalace split ~/chats/ --dry-run # Run the actual split mempalace split ~/chats/ # Only split files that contain 3 or more sessions mempalace split ~/chats/ --min-sessions 3
Mining Your Conversations into the Palace
With your files split and ready, run the mining command. Choose the mode that matches your goal:
# Standard mining — stores everything verbatim mempalace mine ~/chats/ --mode convos # Assign all mined content to a specific wing mempalace mine ~/chats/ --mode convos --wing myproject # Auto-classify content into hall types (decisions, milestones, preferences...) mempalace mine ~/chats/ --mode convos --extract general
The --extract general flag runs auto-classification on top of standard mining. It takes longer but organises content into the five hall types: hall_facts (locked decisions), hall_events (sessions and milestones), hall_discoveries (new insights), hall_preferences (habits and opinions), and hall_advice (recommendations).
Verifying the Import
mempalace status → Wings: 4 | Rooms: 27 | Drawers: 2,341 | KG triples: 89 # Test with something you know you discussed mempalace search "why did we choose this database" → Returns verbatim passages from your actual conversations
If the search returns relevant passages you recognise, the import worked correctly. If the palace shows zero drawers, check that your chat export file was found — run the mining command with the explicit file path to confirm.
Importing Slack Exports
- In Slack, open your workspace settings and navigate to Import and Export Data
- Click Export, then select All Messages from the date range options
- Slack will email you a download link for a ZIP archive containing JSON files organised by channel
- Unzip the archive and mine the resulting directory:
mempalace mine ~/slack-export/ --mode convos --wing teamnameAssigning a wing name with --wing keeps Slack content separated from your personal AI conversations, which makes retrieval more precise.