Nexus AI Chat Importer

Import your AI chat exports into your Obsidian vault as plain Markdown — organised by provider and date, with attachments, frontmatter metadata, and a reviewable import report. Everything runs locally in your vault.

🌍 Translated docs — the user guide is also published on nexus-prod.dev in Deutsch · Español · Français · Italiano · 日本語 · 한국어 · Português · Русский · 中文

Note: the optional command-line importer has moved to its own repository, nexus-ai-chat-importer-cli. The Obsidian plugin is unaffected.

Supported providers

ChatGPT · Claude · Mistral Vibe (formerly Le Chat) · Perplexity

Features

• Import all, or select conversations with an interactive preview and filters.
• Incremental updates — re-import a newer export and only new messages are appended; your edits are kept. Or explicitly rebuild notes to pick up new features.
• Smart deduplication across multiple export archives.
• Best-effort attachments — images, documents, and generated content are extracted when the export contains them; anything missing is shown explicitly.
• Structured Markdown — role callouts, ISO 8601 UTC frontmatter, per-provider folders, and a detailed import report.
• Localised UI in 10 languages, with translated documentation and an optional desktop CLI.

What's new in 1.7.0

• ChatGPT generated images and documents are imported again when the export includes them.
• ChatGPT Privacy Portal archives import as-is — no need to extract the account-level ZIP first.
• Rebuild existing notes so older imports pick up current features. Manual edits to a rebuilt note are lost.
• Filter the conversation list by status — New / Updated / Unchanged.
• Large Claude inline content (pasted) is extracted into linked files instead of bloating the note.
• Reports and the completion dialog were rebuilt around what actually happened to your notes; several counters were wrong.
• Plus fixes to filenames, deduplication and attachment counts.
• Claude imports work again — Anthropic's new split export was read as a ChatGPT one and imported nothing. (patched in 1.6.9)
• Callout colours restored on Obsidian 1.13+ — Obsidian changed the colour format and Nexus callouts lost their colour and border. (patched in 1.6.9)

Full release notes →

Install

From Obsidian: Settings → Community plugins → Browse → search Nexus AI Chat Importer → Install → Enable. Requires Obsidian 1.6.6+; works on desktop and mobile.

Manually: download main.js, manifest.json, and styles.css from the latest release into <vault>/.obsidian/plugins/nexus-ai-chat-importer/, then enable the plugin.

Then run Import AI conversations from the command palette or the ribbon icon. See Getting started.

Documentation

Full documentation lives in docs/:

Location	For	Contents
docs/user/	Everyone	Canonical user guide: getting started, importing, settings, what gets created, attachments, reports, CLI, privacy, troubleshooting, and a page per provider.
docs/development/	Contributors	Adding a provider, issue workflow, release workflow.
docs/architecture/	Contributors	Import pipeline, archive pipeline, attachment handling, link updates, ChatGPT export format.
RELEASE_NOTES.md	Everyone	The changelog.

Support

I maintain Nexus AI Chat Importer in my own time, and testing new providers means paying for their subscriptions. If it is useful to you, please consider a one-time or monthly donation — thank you to everyone already supporting the project.

The plugin invites you to donate after your first import and every few imports after that; you can always dismiss the dialog.

License

GNU General Public License v3.0 or later (GPL-3.0-or-later), since version 1.3.0. Versions ≤ 1.2.0 remain under their original MIT license. You may use, modify, and redistribute the plugin; derivative works must also be GPL-3.0 and provide their source. See LICENSE for the full text.

Credits

• 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)
  • @lstsavr — Unicode filename preservation (PR #70)
• Special Thanks: To all users who report issues and suggest improvements

Links

Issues · Obsidian forum thread · Releases