Docs / Connect / Claude export
A Claude export arrives as several zip files, and the one that matters can hold a single conversations file of hundreds of megabytes. The claude-export source reads that file as a stream, one conversation at a time, so memory use stays small, and indexes each conversation as one memory in a partition of its own. It follows the visible reply chain. Available from ModelBrain 0.6.6.
conversations-000.zip, which holds conversations.json.conversations.json.From a terminal, connector_sync register <id> <path> --type claude-export does the same. For example: connector_sync register claude ~/Downloads/conversations-000.zip --type claude-export.
conversations.json file, streamed. It is never held whole in memory.[file: name], or [attachment]. No attachment contents are read.User or Assistant heading, so search can tell who said what. A passage you wrote ranks above the same words in a reply.A container file over 4 GiB is refused and recorded as a failure, not dropped. Set MODELBRAIN_CONTAINER_MAX_BYTES to change that ceiling. A single conversation over 32 MiB is refused the same way, and the rest of the export carries on.
While it indexes, ModelBrain writes the conversation text to a private temporary file, then deletes it when the work is done. Allow a few hundred megabytes of free disk space for a large export. If the export cannot be read to the end, every conversation already indexed stays put until the next good pass.
This source is hidden from relay callers. Anything that reaches ModelBrain through the hosted relay, which is how ChatGPT and Grok connect, cannot see what this source imported unless you add its partition (and the partition of any other source of the same kind) to that connection's allowlist yourself. Your chat history is the most personal thing in this list, so check the partition before you share a ModelBrain store with anyone.
kind, members, members_failed and last_container_bytes.The zip held no conversations.json, or the file was cut off or not valid JSON. Download the export again and pick conversations-000.zip.
It may have had no dialogue text, or it was over 32 MiB and was recorded as a failed member. Check the counts in diagnostics.
Open the ModelBrain menu, choose Vaults, then Add Source, then Claude export. Say whether you have the zip or the folder, then pick it. Available from ModelBrain 0.6.6.
No. The file is read as a stream, one conversation at a time, so memory use stays near the size of one conversation.
No. This source reads only the conversations file. The other zips in the export are never opened.
No. The partition is hidden from relay callers, which is how ChatGPT and Grok connect.
Each source kind has its own page.
ChatGPT export → · Grok export → · Mail → · Claude Code memory →Sources feed the same memory these assistants read.
Claude Desktop → · Claude Code → · Cursor →