1. About
2. Overview
3. Features
4. Installation
5. Configuration
6. Usage
   1. Exporting ChatGPT Data
   2. Importing into Obsidian
   3. Import Results
   4. Resetting the Import Catalog
7. Understanding the Import Report
8. More Features
   1. Opening Conversation in its Original Webapp
9. Troubleshooting
10. Important Notes

Master branch: 1.0.2 (Stable Release)
dev branch: refactor/2.0.0-alpha.3 - Refactoring in progress

The Nexus AI Chat Importer Plugin simplifies the process of importing ChatGPT conversations from export files into Obsidian.

The Nexus AI Chat Importer Plugin for Obsidian allows you to seamlessly import your AI chat conversations from export files into your Obsidian vault. This plugin organizes your ChatGPT conversations into readable Markdown files, making them easily accessible and searchable within Obsidian.

• Import conversations from export files directly into Obsidian
• Automatically organize conversations by date
• Create individual Markdown files for each conversation
• Update existing conversations with new messages
• Detailed import reports for tracking the import process
• One-time upgrade check to ensure users are up-to-date
• Improved import reports with more accurate and detailed information

1. Download the contents of the dist folder from the repository.
2. In your Obsidian vault, navigate to the .obsidian/plugins/ directory.
3. Create a new folder called nexus-ai-chat-importer.
4. Copy the downloaded files into the nexus-ai-chat-importer folder.
5. Open Obsidian and go to Settings > Community Plugins.
6. Disable Safe Mode if it's enabled.
7. Refresh the list of plugins.
8. Find "Nexus AI Chat Importer" in the list and enable it by toggling the switch.

Note: You may need to restart Obsidian after installing the plugin for it to appear.

For detailed installation instructions, please refer to the README file included in this release.

1. Go to Settings > Nexus AI Chat Importer
2. Set the "Nexus AI Chat Importer Folder" to specify where imported conversations will be stored
3. Optionally, enable "Add Date Prefix to Filenames" and choose a date format

1. Log in to ChatGPT (chat.openai.com)
2. Click on your user icon and select "Settings & Beta"
3. Go to "Data Controls" and click on "Export Data"
4. Click "Export" and wait for an email with the download link
5. Download the ZIP file containing your ChatGPT data

1. In Obsidian, open the Command Palette (Cmd/Ctrl + P)
2. Search for and select "Nexus AI Chat Importer: Select export archive"
3. Choose the ZIP file you downloaded from ChatGPT
4. The plugin will process the file and import your conversations

• New conversations will be created as individual Markdown files
• Existing conversations will be updated with new messages (if any)
• An import report will be generated in the archive folder, detailing the results

1. Open the Command Palette (Cmd/Ctrl + P)
2. Search for and select "Reset Nexus AI Chat Importer Catalogs: Reset Catalogs"
3. Confirm the action when prompted

The import report provides a summary of the import process, including:

• Total number of existing conversations
• Number of new conversations imported
• Number of conversations updated
• Number of new messages added

It also includes detailed tables for created, updated, and skipped notes.

By clicking the note title, you will be directed to the original conversation webapp directly in your default browser. Be aware that:

1. The conversation must still exist in your account history.
2. You need to be authenticated in your browser.
3. You may require an active subscription to access your chat history.

• If the import fails, check the console log for error messages.
• Ensure you have write permissions for your Obsidian vault.
• Verify that the ZIP file is a valid ChatGPT export.

• This version introduces new metadata parameters required for certain features. Users are advised to re-import their conversations to ensure full functionality.
• The plugin has been officially renamed to "Nexus AI Chat Importer" to better reflect its functionality.
• For users upgrading from previous versions, it's recommended to delete old data and re-import conversations with this new version for optimal performance and feature compatibility.

For more detailed information about the latest release, please refer to the Release Notes.