Glossary
A single email message file on disk. Use ingest eml when you already have one or more of these
files locally.
A mailbox file on disk that can contain many messages. Use ingest mbox when you already have an
mbox file locally. This is not the same thing as IMAP sync.
sync imap
Section titled “sync imap”The MailAtlas command for connecting to a live mailbox over IMAP and fetching selected folders into the local workspace. This is the live-mailbox path.
workspace
Section titled “workspace”The directory that holds raw email, normalized HTML, extracted assets, and optional exports.
document
Section titled “document”The normalized MailAtlas record stored in SQLite and linked to files in the workspace.
A file extracted from a message, such as an inline image or another stored artifact associated with the document.
export
Section titled “export”A derived JSON, Markdown, HTML, or PDF artifact written from a stored document.