Exporting memories

You can export your memories as a ZIP of Markdown files at any time — to keep a copy, migrate, or review offline. Exports contain only what you're allowed to see, and never another organization's data or deleted memories.

Choosing a scope

Start an export from Govern › Exports and pick one of three scopes:

  • Everything — every scoped memory you can see, plus every tagged memory.
  • A subtree — the scoped memories under one folder you pick and its descendants. (Tagged memories attach to a layer, not a path, so a subtree export is scoped-only.)
  • Tagged only — just the tagged memories.

The export holds published memories plus your own pending proposals (the same visibility rule as retrieval): your pending edits overlay the published body, and your pending creates are folded in as the files they'd become on approval. Nobody else's pending work, and no other tenant's data, is ever included.

It runs in the background

Exports are generated asynchronously. You start one, it runs, and the finished ZIP lands in your export history to download. The history lists your exports newest-first; a failed export can be retried.

The ZIP layout

Files are foldered by where each memory lives.

Scoped memories mirror their canonical path — each segment becomes a folder, and the memory's key becomes the .md filename:

root/pennine-joinery/vat/vat-scheme.md
root/camden-roasters/year-end/year-end-notes.md

Tagged memories live under a _tagged/ folder, keyed by layer (and value, when value-targeted):

_tagged/services/working-papers.md          (layer-wide)
_tagged/services/vat/vat-signoff.md          (value-targeted: services=vat)

Front matter on every file

Every file opens with a YAML front-matter block, then the memory body. Scoped memories carry:

---
id: 019f2c...           # the memory's id (empty for a pending create)
kind: scoped
title: VAT flat-rate scheme
key: vat-scheme
path: root.pennine-joinery.vat
version: 3
updated: 2026-07-05T12:00:00Z
---

Tagged files carry the same fields, but with layer (and value when value-targeted) in place of path:

---
id: 019f2d...
kind: tagged
title: Working-papers standard
key: working-papers
layer: services
version: 2
updated: 2026-07-05T12:00:00Z
---

The layout and front matter are deterministic, so an export is stable and diff-friendly.

Download expiry

A completed export's download link and file are kept for 7 days, then purged. The export history shows a countdown so you know how long a given archive stays downloadable; after it expires, generate a fresh export. This keeps stale archives of your memory from lingering indefinitely.

Next steps