chatgpt-import · diff
git:20260223.ea9216f to git:20260419.cd38913
23 added, 6 removed. Audit A to A.
---
- name: "ChatGPT Import"
- description: "Import conversation history from ChatGPT into Vellum"
- metadata: {"vellum": {"emoji": "📥"}}
- user-invocable: true
+ name: chatgpt-import
+ description: Import conversation history from ChatGPT into Vellum
+ compatibility: "Designed for Vellum personal assistants"
+ metadata:
+ emoji: "📥"
+ vellum:
+ display-name: "ChatGPT Import"
---
Import ChatGPT conversation history into Vellum so users can keep their conversation context and memory when switching from ChatGPT.
## How to guide the user
When a user wants to import their ChatGPT conversations:
- 1. **Tell the user how to export.** They need to go to ChatGPT → Settings → Data controls → Export data. ChatGPT will email them a ZIP file.
+ 1. **Tell the user how to export.** They need to go to ChatGPT Settings > Data controls > Export data. ChatGPT will email them a ZIP file.
2. **Ask the user to upload the ZIP file.** Use whatever file upload tools or skills are available to receive the ZIP.
- 3. **Run the import.** Once you have the ZIP file path, call `chatgpt_import` with the file path. Report the results — how many conversations and messages were imported, and any skipped duplicates.
+ 3. **Run the import.** Once you have the ZIP file path, run:
+
+ ```bash
+ bun run scripts/parse-export.ts --file "$ZIP_PATH" | assistant conversations import --json
+ ```
+
+ The `parse-export.ts` script parses the ChatGPT ZIP and converts it to the standard import format. The `assistant conversations import` command reads the JSON from stdin and creates the conversations.
+
+ The command returns JSON:
+
+ ```json
+ { "ok": true, "imported": 12, "skipped": 0, "messages": 347 }
+ ```
+
+ Report the results — how many conversations and messages were imported, and any skipped duplicates.
## Notes
- Only ZIP files are accepted (the full export archive from ChatGPT).
- Conversations are deduplicated — re-importing the same file will skip already-imported conversations.
- Only user and assistant messages are imported (system prompts and tool calls are filtered out).
- Original timestamps from ChatGPT are preserved.
- Imported conversations are automatically indexed for memory search.