Skip to content

bundles.md

Latest commit

 

History

History
90 lines (62 loc) · 2.42 KB

bundles.md

File metadata and controls

90 lines (62 loc) · 2.42 KB

Memory Bundles

Use memory bundles to export a project's curated memories and import them into another project.

Table of Contents

What A Bundle Contains

By default, a bundle exports:

  • active canonical memories
  • tags
  • relations between exported memories
  • a deterministic Markdown summary

By default, a bundle does not export:

  • raw captures
  • tasks or sessions
  • writer/session IDs
  • embeddings or chunks
  • source excerpts, file paths, or git commit hashes unless you explicitly include them

Export A Bundle

CLI:

memory bundle export --project my-project --out my-project.mlbundle.zip

Optional source/provenance fields:

memory bundle export \
  --project my-project \
  --out my-project.mlbundle.zip \
  --include-archived \
  --include-source-file-paths \
  --include-git-commits

Web UI:

  • open the Bundles tab
  • choose the export checkboxes
  • preview the summary and warnings
  • download the bundle

Preview And Import A Bundle

Preview first:

memory bundle import --project target-project ./my-project.mlbundle.zip --dry-run

Import:

memory bundle import --project target-project ./my-project.mlbundle.zip

Import behavior:

  • the bundle is merged into the target project
  • imported memories get new local IDs
  • repeated import of the same unchanged bundle entries is skipped
  • if an imported entry changes for the same bundle lineage, the previous imported copy is replaced with a new immutable memory

After import, Memory Layer rebuilds search chunks for the target project. Embeddings are not shipped inside the bundle.

memory bundle export and memory bundle import both support --dry-run. For export, dry-run computes the bundle preview and intended output path without writing the archive file. For import, dry-run is the preview mode and does not change the target project.

Privacy Defaults

The default export is conservative.

  • canonical memory text is included
  • provenance-like fields are excluded unless explicitly selected
  • the export preview warns about likely sensitive values such as emails, token-like strings, phone-number-like strings, and absolute local paths

This is intended for sharing memory sets without accidentally shipping unnecessary local context.