• ⚡ Quickstart - Get up and running in 2 minutes
• 📥 Installation - Install from Community Plugins
• 📤 Export Your Chats - Get your data from ChatGPT/Claude/Le Chat

• 📥 Import Conversations - Quick or selective import
• 📊 Import Reports - Understand what was imported
• 📁 File Organization - Where your files are stored
• 🎨 Conversation Format - How conversations look

• 📎 Attachments - Images, DALL-E, artifacts
• 🤖 Provider Differences - ChatGPT, Claude, Le Chat specifics
• 💻 CLI - Import from command line
• ⚙️ Settings - Customize folders and formatting
• 🔧 Troubleshooting - Common issues and solutions

• ✨ What's New - v1.4.0 features
• ☕ Support - Help keep this plugin alive
• 📜 License - GPL-3.0

Get started in 2 minutes:

1. Install the plugin from Obsidian Community Plugins (search "Nexus AI Chat Importer")
2. Export your chats:
   • ChatGPT: Settings → Data controls → Export data → Download ZIP
   • Claude: Settings → Privacy → Export data → Download ZIP
   • Le Chat: Click your name → Profile → Le Chat: Export → Download
3. Import: Click the ribbon icon (chat +) in the left sidebar or use command palette → "Import AI conversations"
4. Select your ZIP file(s) → Choose import mode (all or selective)
5. Done! Your conversations are now in Nexus/Conversations/

💡 First time? The plugin will show you a welcome dialog with helpful links!

Import your AI chat conversations from ChatGPT, Claude, and Le Chat exports into Obsidian as beautifully formatted Markdown files.

• Multi-provider support (ChatGPT, Claude, Le Chat)
• Selective import with interactive preview
• Smart deduplication across multiple ZIPs
• Attachment handling — images, documents, DALL-E, artifacts (provider-dependent)
• Claude artifact versioning
• LaTeX math support
• CLI for automation and headless setups
• Beautiful formatting with role-specific callouts
• Detailed import reports
• International date support

• 🤖 Le Chat (Mistral AI) — Full support with attachments, references, and citations
• 💻 CLI for Bulk Import — Import from the terminal without opening Obsidian (see docs)

• Human-readable artifact folders — Claude artifacts now stored in folders named after the conversation, not UUIDs
• LaTeX math — Math equations are properly handled and converted to Obsidian syntax
• Large archive support — All providers now handle very large exports reliably

• Multiple attachments in a single message no longer break out of the parent callout
• Claude artifacts render correctly for both old and new export formats
• Mobile artifact placeholders no longer show raw text
• Binary files referenced by Claude scripts no longer saved as empty artifacts

Upgrading from a previous version triggers required migration tasks automatically.

For v1.3.x and earlier release notes, see RELEASE_NOTES.md

I'm working on Nexus projects full-time while unemployed and dealing with health issues.

Over 6,500 downloads so far! Thank you to everyone who has supported this project.

If this plugin makes your life easier, a donation would mean the world to me and help keep development going strong.

Why support?

• 🚀 Faster development - More time for features and improvements
• 🐛 Better support - Quicker bug fixes and responses
• 💡 New features - Your suggestions become reality
• ❤️ Motivation - Shows that my work is appreciated

• 🎯 Selective Import: Choose exactly which conversations to import with interactive preview
• 💬 Multi-Provider Support: Full support for ChatGPT, Claude, and Le Chat conversations
• 🎨 Beautiful Formatting: Custom callouts with role-specific colors and icons
• 📎 Complete Attachment Handling: Images, documents, DALL-E creations with prompts
• 🎨 Claude Artifact Versioning: Separate files for each artifact modification
• 📊 Detailed Reports: Comprehensive import statistics with per-file breakdown
• 🗂️ Flexible Organization: Separate folders for conversations, attachments, and reports
• 🌍 International Support: ISO 8601 timestamps, works with all locales
• ⏱️ Progress Tracking: Real-time feedback during large imports
• 🔄 Smart Deduplication: Handles multiple ZIP files without creating duplicates

💡 Tip: Screenshots coming soon! For now, try the plugin yourself - it's free and takes 2 minutes to set up.

From Obsidian Community Plugins (Recommended):

1. Open Settings → Community Plugins
2. Click Browse and search for "Nexus AI Chat Importer"
3. Click Install, then Enable

Manual Installation:

1. Download the latest release from GitHub Releases
2. Extract files to .obsidian/plugins/nexus-ai-chat-importer/
3. Reload Obsidian and enable the plugin

After installing the plugin:

1. Open Settings → Community Plugins → Nexus AI Chat Importer
2. Configure your folders (or keep the defaults):
   • Conversations: Where your chat notes will be saved
   • Attachments: Where images and files will be stored
   • Reports: Where import summaries will be created
3. Configure filename options:
   • Add Date Prefix: Enable to add dates to conversation filenames (e.g., 2024-01-15 - My Chat.md)
   • Date Format: Choose between YYYY-MM-DD (2024-01-15) or YYYYMMDD (20240115)
4. Chose message date format:
   • Custom date format If Obsidian Locale is not providing the format you want (i.e. english provides US format MM/DD/YYYY), select the format you prefer. The plugin will apply it to messages in conversations while importing

Good news: The plugin handles everything automatically!

When you upgrade to a new version:

• ✅ Your settings are migrated to the new format
• ✅ Your existing conversations are updated with new features
• ✅ Folders are reorganized if needed (with your permission)
• ✅ A detailed upgrade report shows you what changed

No manual work required - just install and go!

Choose where your files are stored:

• Conversations Folder: Your chat notes (default: Nexus/Conversations)
• Attachments Folder: Images, files, and Claude artifacts (default: Nexus/Attachments)
• Reports Folder: Import summaries (default: Nexus/Reports)

💡 Tip: You can organize these folders however you like! Put them all together, or spread them across your vault.

Customize how your conversations look:

• Date Prefix: Add dates to filenames

  • ✅ Enabled: 2024-01-15 - My Conversation.md
  • ❌ Disabled: My Conversation.md

• Date Format: Choose your style

  • With dashes: 2024-01-15
  • Without: 20240115

• Message Timestamps: Choose how dates appear in messages

  • Auto (default): Matches your Obsidian language
  • Custom: Pick from ISO 8601, US, European, UK, German, or Japanese

Want to reorganize? No problem!

1. Change a folder path in settings
2. Click Save
3. Choose what to do:
   • ✅ Move files: Everything moves automatically, links stay working
   • ❌ Leave files: They stay put (but won't be managed by the plugin anymore)

💡 Pro tip: The plugin is smart - it merges folders instead of overwriting, so your existing files are safe!

ChatGPT:

1. Open ChatGPT → Settings → Data Controls → Export data
2. Check your email (arrives in a few minutes)
3. Download the ZIP file

Claude:

1. Open Claude → Settings → Privacy → Export data
2. Check your email (arrives in a few minutes)
3. Download the ZIP file

Le Chat:

1. Click your name → Profile → Le Chat: Export
2. Wait for the button to change from "Export" to "Download"
3. Click Download to get the ZIP file

Two ways to start:

• Click the ribbon icon (chat +) in the left sidebar, OR
• Press Ctrl/Cmd+P → type "Import AI conversations"

Perfect when you want everything imported fast:

1. Select ChatGPT, Claude, or Le Chat
2. Choose your ZIP file(s)
3. Click Import All
4. Done! ✨

Perfect when you want control:

1. Select ChatGPT, Claude, or Le Chat
2. Choose your ZIP file(s)
3. Click Select Conversations
4. Review the list - you'll see:
   • 📝 Conversation title and date
   • 💬 Number of messages
   • 🆕 New / 🔄 Updated / ✅ Already imported
   • 📎 Attachments info
5. Filter conversations (optional):
   • 🔍 Search by keyword - Type in the search box to filter by title
   • 📊 Filter by status - Show only New, Updated, or Already imported
   • 📅 Sort - By date, title, or status
6. Select conversations:
   • ✅ Check individual conversations
   • ✅ Use "Select All" / "Deselect All" buttons
   • ✅ Use "Select New Only" to import only new conversations
7. Click Import Selected

Cool features:

• ✅ Keyword search - Find conversations by title instantly
• ✅ Smart filtering - Show only what you need
• ✅ Multi-ZIP support - Process multiple exports at once
• ✅ Duplicate detection - Automatically finds duplicates across ZIPs
• ✅ Flexible sorting - Organize by date, title, or status

After every import, you get a beautiful summary report:

What's in it:

• ✅ How many conversations were imported
• ⏱️ How long it took
• 📊 Success rate
• 📎 Attachment statistics
• 🔗 Clickable links to your new conversations

Where to find it: <reports>/<provider>/import-YYYYMMDD-HHMMSS.md

💡 Tip: The report opens automatically when import finishes!

Conversations are organized by provider, year, and month:

<conversations>/
├── <provider>/
│   └── YYYY/
│       └── MM/
│           └── YYYY-MM-DD - conversation-title.md

Example (with date prefix enabled):

<conversations>/chatgpt/2024/01/2024-01-15 - my-conversation.md
<conversations>/claude/2024/02/2024-02-20 - another-chat.md

Example (without date prefix):

<conversations>/chatgpt/2024/01/my-conversation.md
<conversations>/claude/2024/02/another-chat.md

Each conversation note contains:

1. Frontmatter - Rich metadata for Obsidian features:

---
conversation_id: "abc123..."          # Unique identifier
provider: "chatgpt"                   # chatgpt, claude, or lechat
title: "Conversation Title"           # Original title
create_time: "2024-01-15T14:30:22Z"  # Creation timestamp (UTC, ISO 8601)
update_time: "2024-01-15T16:45:10Z"  # Last update timestamp (UTC, ISO 8601)
message_count: 42                     # Total messages
aliases: ["Conversation Title"]       # For linking
---

This metadata enables powerful Obsidian features:

• 🔍 Search & filter by any field
• 📊 Dataview queries for custom dashboards
• 📈 Track statistics across conversations
• 🔗 Link using aliases

2. Header - Title with link to original conversation:

# Conversation Title
[View original conversation](https://chatgpt.com/c/abc123...)

Note: If you deleted the conversation online, the link will be dead.

3. Messages - Formatted with custom callouts:

> [!nexus_user]
> **User** - 2024-01-15 14:30:22
>
> Your message here...

> [!nexus_assistant]
> **Assistant** - 2024-01-15 14:31:05
>
> AI response here...

Callout Types:

• 👤 nexus_user: Blue callouts for user messages
• 🤖 nexus_assistant: Green callouts for AI responses
• 📎 nexus_attachment: Amber callouts for attachments
• ✨ nexus_artifact: Purple callouts for Claude artifacts
• 🪄 nexus_prompt: Red callouts for DALL-E prompts

Viewing Modes:

• Reading View: Full visual experience with colored callouts
• Live Preview: Rendered callouts while editing
• Source Mode: Raw Markdown syntax

The plugin uses two different date formats depending on where they appear:

1. Metadata (Top of File) - Universal Format

The dates at the top of each note use ISO 8601 format (2024-01-15T14:30:22.000Z):

✅ Works everywhere - No matter what language you use ✅ Sorts correctly - Alphabetical order = chronological order ✅ No confusion - Never mix up month and day ✅ Works with Dataview - Perfect for queries and tables ✅ Same timezone - Always UTC (no timezone confusion)

2. Message Timestamps (In Conversation) - Your Choice

The timestamps shown in each message can be customized:

• Auto (Default): Matches your Obsidian language

  • English → 01/15/2024 2:30:22 PM
  • French → 15/01/2024 14:30:22
  • German → 15.01.2024 14:30:22

• Custom: Pick your favorite format in Settings

  • Universal: 2024-01-15 14:30:22 (same everywhere, easy to sort)
  • US: 01/15/2024 2:30:22 PM
  • European: 15/01/2024 14:30:22
  • German: 15.01.2024 14:30:22
  • Japanese: 2024/01/15 14:30:22

⚠️ Important: Changing this setting only affects new imports. Your existing notes won't change (to protect your data).

Example of Universal Format: 2024-01-15T14:30:22.000Z

• Date: January 15, 2024
• Time: 2:30:22 PM (in UTC timezone)
• Why UTC? So the same timestamp works everywhere in the world

✅ DO:

• Add your own frontmatter fields - the plugin won't touch them
• Edit message content as needed
• Use Reading View for best experience

❌ DON'T:

• Modify plugin-generated frontmatter fields (conversation_id, provider, etc.)
• Delete message IDs (hidden in Reading View)
• Remove messages - they'll be restored on reimport

Why? The plugin uses conversation_id and message IDs to detect updates and avoid duplicates. Modifying them breaks this functionality.

Attachments are organized by provider:

<attachments>/
└── <provider>/
    ├── images/
    ├── documents/
    └── artifacts/  (Claude only)

Example:

<attachments>/chatgpt/images/dalle-abc123.png
<attachments>/claude/artifacts/conv-id/script_v1.py

Images:

• User-uploaded photos and screenshots
• AI-generated images (DALL-E with prompts)
• Embedded directly in conversation notes

Documents:

• PDFs, text files, code files
• Linked in conversation notes

Claude Artifacts (when included in export):

• Code, documents, and AI-generated content
• Saved as separate versioned files when content is available
• Each modification creates a new version (v1, v2, v3...)
• ⚠️ Note: Claude exports often don't include artifact content - see Provider Limitations

Some attachments may be missing from exports:

• Older exports: May not include all files
• Large files: Sometimes excluded from ZIP
• External links: Not downloadable

The plugin continues importing even with missing attachments. Check import reports for details.

Each AI provider has unique characteristics in how they export conversations. Here's what you need to know:

✅ Fully Supported:

• Conversation titles (exported in JSON)
• User-uploaded attachments (images, documents)
• DALL-E generated images with prompts
• Complete message history
• Custom instructions and model information

Export Format: Single conversations.json file with all conversations + attachments in ZIP

✅ Fully Supported:

• Conversation titles (exported in JSON)
• User-uploaded attachments (images, documents)
• Complete message history
• Artifacts with full content and versioning

⚠️ Limitations:

• Mobile view limitations: Conversations viewed on mobile show placeholder text instead of displaying artifacts inline. While artifact files are extracted correctly to the artifacts folder, these mobile placeholders cannot be automatically linked to their corresponding artifact files in the conversation view
• Export format change: Anthropic changed the Claude export format structure over time. Conversations imported with plugin v1.3.x may be missing inline artifact callouts. The v1.4.0 migration automatically restores artifact links at the end of affected notes. To get artifacts positioned inline within messages, delete the note and re-import from your Claude export ZIP

Export Format: Single conversations.json file with all conversations + attachments in ZIP

💡 Tip for Claude Users:

• Artifacts are fully extracted and saved with versioning - check your artifacts folder
• For conversations viewed on mobile, artifact files are still created but inline callouts may not show in messages
• If you upgraded from v1.3.x and are missing artifact links, they have been restored at the bottom of affected notes during the v1.4.0 migration

✅ Supported:

• User-uploaded attachments (images, documents)
• Complete message history
• References and citations
• Custom elements

⚠️ Limitations:

• No conversation titles: Le Chat exports don't include conversation titles. The plugin automatically generates titles from the first user message (truncated to 50 characters)
• No generated images: Images created by Le Chat's image generation tool are not included in exports. Only external URLs are provided, which may expire. The plugin will show the generation prompt but cannot download the images
• Tool calls filtered: Internal tool calls (web_search, etc.) are filtered out as they're not useful for users

Export Format: Individual chat-{uuid}.json files (one per conversation) + attachments in chat-{uuid}-files/ directories

💡 Tip for Le Chat Users:

• If you want to preserve generated images, download them manually before exporting
• Consider adding custom titles to your conversations by editing the imported notes' frontmatter

⚠️ Not Currently Supported - Research Stage

Google Gemini exports present unique technical challenges that may make full support impractical. Unlike other providers, Gemini Takeout data lacks conversation IDs, making it impossible to reconstruct conversations from the export alone.

Why It's So Hard:

• Takeout provides messages without conversation identifiers
• No way to group related messages into conversations
• Requires external metadata that Google doesn't include

Experimental Approach: I'm exploring a solution using a browser extension to capture conversation metadata directly from the Gemini web UI, which would then be combined with Takeout data to reconstruct conversations. However, this is complex, fragile, and may never reach production quality.

Status: Research only. No timeline, no guarantees, no promises - just experimentation.

You may notice Gemini code in the repository - it's experimental and disabled in v1.4.0.

You can safely reimport the same ZIP file multiple times. The plugin intelligently handles updates:

What Happens:

• ✅ New conversations → Added
• ✅ Updated conversations → Refreshed with new messages
• ✅ Unchanged conversations → Skipped
• ✅ No duplicates → Smart detection prevents duplicates

When to Reimport:

• You've had more conversations since last export
• Plugin update adds new features
• Fix issues from previous import
• Retry failed attachments

What's Updated:

• Messages and content
• Attachments and artifacts
• Frontmatter metadata
• Formatting

What's Preserved:

• Your manual edits (if frontmatter/message IDs intact)
• Existing attachments
• Folder structure

Import conversations without opening Obsidian — useful for automation, large archives, or headless setups.

The CLI is included in the plugin source. To use it:

1. Clone or download the repository
2. Run npm install then npm run build
3. Use the CLI from the cli/ directory

nexus-cli import --vault /path/to/vault --input export.zip --provider chatgpt [options]

# Import a ChatGPT export
nexus-cli import --vault ~/my-vault --input chatgpt-export.zip --provider chatgpt

# Import a Claude export
nexus-cli import --vault ~/my-vault --input claude-export.zip --provider claude

# Import a Le Chat export
nexus-cli import --vault ~/my-vault --input lechat-export.zip --provider lechat

# Import multiple files with date prefix
nexus-cli import --vault ~/my-vault --input export1.zip export2.zip --provider chatgpt --date-prefix

# Preview without writing (dry run)
nexus-cli import --vault ~/my-vault --input export.zip --provider chatgpt --dry-run

Note: The CLI reuses the same import engine as the plugin. Conversations imported via CLI are fully compatible with the plugin and vice versa.

Projects:

• Project organization is not currently supported
• All conversations are imported individually
• Future versions may add project support

Performance:

• Large archives (1000+ conversations) take several minutes to analyze
• Obsidian may become temporarily unresponsive during processing
• Progress dialogs show real-time status

Storage:

• Attachments can significantly increase vault size
• AI-generated images can be several MB each
• Consider excluding <attachments>/ from cloud sync

"Invalid file format" error:

• Only ZIP files are supported (must have .zip extension)
• Known Issue (Claude + Firefox on Mac): The downloaded file may have a .dat extension instead of .zip
  • Solution: Simply rename the file to change .dat to .zip (do NOT extract and re-compress!)
  • This is a browser/server issue that has been reported to Anthropic
• If you manually compressed a folder, make sure it's a valid ZIP format

Import stuck or slow:

• Large archives take 5-10 minutes
• Check progress dialog
• If frozen, restart Obsidian

No conversations appear:

• Verify correct provider selected
• Check ZIP file is valid export
• Review import report for errors

Safari users (Mac) - ZIP file issues:

• Safari automatically unzips downloaded files by default
• This creates a folder instead of keeping the ZIP file
• Solution: Disable auto-unzip in Safari:
  • Safari → Preferences → General
  • Uncheck "Open 'safe' files after downloading"
  • Re-download the export from ChatGPT/Claude/Le Chat
• Note: This is a Safari feature, not a plugin bug
• Do NOT manually re-compress unzipped folders (creates incorrect structure)

Missing attachments:

• Check import report for details
• Older exports may not include all files
• Reimport to retry failed attachments

Callouts not displaying:

• Use Reading View
• Update Obsidian to latest version
• Try different theme

Need help?

1. Check import report for errors
2. Verify settings are correct
3. Open issue on GitHub with:
   • Plugin & Obsidian versions
   • Provider (ChatGPT/Claude/Le Chat)
   • Problem description

I'm constantly working to improve the plugin. Here's what's planned for future releases:

• 💡 Suggest Features: Open an issue on GitHub with your ideas
• 🐛 Report Bugs: Help us improve by reporting issues
• ☕ Support Development: Buy me a coffee to speed up development
• ⭐ Star the Repo: Show your support on GitHub

Your feedback and support directly influence what features get prioritized!

GNU General Public License v3.0 (GPL-3.0)

This project is licensed under GPL-3.0 starting from version 1.3.0.

What this means:

• ✅ Free to use - The plugin is and will always be free
• ✅ Open source - Source code is publicly available
• ✅ Can modify - You can modify the code for personal use
• ✅ Can redistribute - You can share modified versions
• ⚠️ Must share source - Derivative works must also be GPL-3.0 and open source
• ⚠️ No commercial use without GPL - Commercial derivatives must also be GPL-3.0

Why GPL-3.0?

This license protects the open-source nature of this project while preventing commercial exploitation without giving back to the community. If you create a commercial product based on this code, it must also be open source under GPL-3.0.

See LICENSE.md for full details.

• Developer: Superkikim
• Contributors:
  • @caseyg — CLI for bulk importing (PR #33), Claude formatting feedback (PR #34)
  • @chuckfs — iOS support (PR #15)
  • @baron — Large archive handling research (PR #27)
• Special Thanks: To all users who report issues and suggest improvements