Skip to content

me_memory_export.md

Latest commit

 

History

History
107 lines (82 loc) · 3.53 KB

me_memory_export.md

File metadata and controls

107 lines (82 loc) · 3.53 KB

me_memory_export

Bulk export memories with filters. Writes to a file or returns content inline.

Prefer path to write directly to a file instead of returning content through the conversation.

Parameters

Name Type Required Description
tree string | null no Tree path filter. Omit or pass null for all memories.
meta object | null no Metadata filter. Omit or pass null to skip.
temporal object | null no Temporal filter. Omit or pass null to skip.
format string yes Output format: "json", "yaml", or "md".
limit integer | null no Maximum memories to export. Omit or pass null for default (1000).
path string | null no Absolute file or directory path. For md format, use a directory path to write one .md file per memory. Omit or pass null to return content inline.

temporal

Name Type Required Description
contains string | null no Find memories containing this point in time.
overlaps object | null no Find memories overlapping this range ({start, end}).
within object | null no Find memories fully within this range ({start, end}).

Returns

When path is provided (file output)

{
  "count": 42,
  "path": "/Users/me/memories/export.yaml"
}

For md format with a directory path:

{
  "count": 42,
  "directory": "/Users/me/memories/export-dir"
}
Field Type Description
count number Number of memories exported.
path string The file path that was written to (JSON/YAML).
directory string The directory that .md files were written to (Markdown).

When path is omitted (inline output)

{
  "count": 3,
  "content": "[{\"id\": \"...\", \"content\": \"...\", ...}, ...]"
}
Field Type Description
count number Number of memories exported.
content string The formatted content string in the requested format.

Examples

Export to file (preferred)

{
  "tree": "me.design.*",
  "format": "yaml",
  "path": "/Users/me/memories/design-export.yaml"
}

Export as Markdown directory

{
  "tree": "me.design.*",
  "format": "md",
  "path": "/Users/me/memories/design-export"
}

Each memory is written as {id}.md with YAML frontmatter. The directory is created if it does not exist.

Export inline for inspection

{
  "meta": { "type": "decision" },
  "format": "json",
  "limit": 10
}

Notes

  • Prefer path for large exports to avoid returning large payloads through the conversation. Omit path only for small result sets or when you need to inspect the content.
  • The exported content is directly compatible with me_memory_import. Exported files and directories can be re-imported directly.
  • Markdown format: use a directory path for multi-memory export. Each memory is written as {id}.md. Inline Markdown export (omitting path) is only supported for single-memory results.
  • Results are sorted in ascending order by creation time.
  • The tree filter supports exact match, wildcards, negation, and label search. See Tree filter syntax for the full reference. Use me.!archived.*{0,} to export everything under me except archived content.
  • See File Formats for full schema documentation and format details.