Skip to content

Portability

Import and Portability

Bring existing Markdown vault context into Origin and keep Origin's readable artifacts portable outside the daemon.

Qi-Xuan LuUpdated 5 min read

At a glance

01

Origin can import Markdown-style vault content without moving or deleting the original files.

02

Origin's pages and session logs are readable Markdown, so the human record remains portable even though retrieval needs the daemon.

01

What import is for

Import is useful when you already have durable project notes, meeting notes, research notes, or a Markdown vault that should become searchable AI work context.

Do not import everything just because it exists. Origin works best when imported material is useful to future agents, not when the memory layer becomes a bulk file mirror.

02

Import a Markdown vault

The vault import path reads Markdown files, chunks them, embeds them, and stores them as imported memories. The source vault is not moved or deleted.

Use a small representative vault first, then recall against it before importing a larger archive. That gives you a chance to see whether the imported context is useful or noisy.

Terminal

origin import vault /path/to/markdown-vault

# readable Origin artifacts
ls ~/.origin/pages/
ls ~/.origin/sessions/

04

Keep ownership clear

If another app is your knowledge-base source of truth, keep using it for polished notes. Use Origin for the AI work loop: captures, handoffs, source-backed pages, recall, and cross-client context.

Running both is possible through MCP, but you still need a human rule for which system owns which kind of context.

05

Read Origin outside the daemon

Origin projects readable artifacts under ~/.origin, including pages and session handoffs. You can open those files in an editor or point a Markdown reader at them.

Plain-text access is not the same as full Origin behavior. Capture, recall, dedupe, distill, review, forget, and index updates still need the daemon and CLI/MCP paths.

06

Privacy and backup caution

Imported vaults and exported-looking Markdown can contain sensitive project history. Do not publish ~/.origin, sync it to a cloud drive, or attach it to an issue without redaction.

For backups, treat ~/.origin and the daemon data directory as private application data. If you need to recover or migrate machines, verify with origin doctor afterward so the daemon, index, and MCP config agree.

Next

Local Git History

Inspect the real git history Origin keeps for local memory, page, session, and status artifacts.

Read next