CONCEPTS

Folder Sync

Folder sync is a CLI-first, one-way import path for local folders. It turns files into document graph nodes while preserving stable source identity for repeat runs.

Folder-in, not mount-out

Memuron does not mount a remote drive or delete graph nodes when a local file disappears. V0 watches the local manifest, detects changed files, and imports supported documents into the target space.

Each synced file gets source metadata such as custom_id and source_url, so re-running sync can update the same graph identity instead of spraying duplicates.

Manifest and identity

The default manifest lives at .memuron/sync-manifest.json. It records the folder root, target space, include/exclude patterns, file hashes, and remote source identity.

manifest

{
  "version": 1,
  "root": "/Users/alex/Documents/field-notes",
  "space_ref": "space.work",
  "include": ["**/*.md", "**/*.pdf"],
  "exclude": ["drafts/**"],
  "files": {
    "brief.md": {
      "custom_id": "folder:brief.md",
      "sha256": "..."
    }
  }
}

The sync engine skips common build folders like node_modules/, .git/, .next/, and dist/ by default. A local .memuronignore file can add project patterns.

CLI commands

Initialize a manifest

Create a manifest for a folder and bind it to a Memuron space.

shell

memuron --tenant-id org_acme sync init \
  --path ~/Documents/field-notes \
  --space-ref space.work \
  --include "**/*.md" \
  --include "**/*.pdf" \
  --exclude "drafts/**"

Run sync

Preview with --dry-run, then run the same command without it to ingest changed files.

shell

memuron --tenant-id org_acme sync run \
  --path ~/Documents/field-notes \
  --dry-run

memuron --tenant-id org_acme sync run \
  --path ~/Documents/field-notes