Ingest files

Read this if you want OMem to ingest documents from a folder on your Mac — your synced OneDrive, an iCloud Drive folder, a project directory, anything. The file kind is the universal one: point it at a directory and it ingests every supported format inside.

Turn it on

The fastest path is the setup wizard, which auto-detects OneDrive / iCloud / Dropbox / Documents and lets you pick. To configure it by hand:

Set the folders to ingest (the “roots”):

omem config set kinds.file.source_config.roots '["~/Library/CloudStorage/OneDrive-Personal", "~/Documents/projects"]'

Enable the kind:
Terminal window
```
omem config set kinds.file.enabled true
```
Ingest:
Terminal window
```
omem ingest --kind file
```

What gets ingested

Every supported format inside your roots — PDF, Word, PowerPoint, Excel, Markdown, text, HTML, images. Two scope filters keep it sane (both adjustable):

Setting	Default	What it does
`kinds.file.scope.max_file_size_mb`	`50`	Skip files larger than this.
`kinds.file.scope.exclude_patterns`	`["~$", ".DS_Store", "node_modules/*"]`	Glob patterns to skip.

For example, to also skip a tmp folder:

omem config set kinds.file.scope.exclude_patterns '["~$*", ".DS_Store", "node_modules/**", "tmp/**"]'

Confirm it worked

omem ingest status        # what the last run did
omem wiki ls --kind file  # the pages it produced

If something didn’t ingest, omem ingest errors shows what failed and why. See observing ingest.

Cloud `.loop` files

When OMem walks a synced OneDrive folder and finds a .loop file, it doesn’t try to parse that binary — it hands it to the loop kind to resolve from SharePoint. See ingest Loop notes.

What’s next

Ingest mail / calendar — the other local sources.
Supported file formats — exactly what each format gets.