export

Mem0 エクスポート

現在のプロジェクトのすべてのメモリを、ポータブルな Markdown ファイルにエクスポートします。

実行

ステップ 1：ID を解決する

アクティブな ID を特定します。

• MEM0_USER_ID 環境変数の user_id。設定されていない場合は $USER、それも設定されていない場合は "default"
• MEM0_PROJECT_ID 環境変数、またはプロジェクトリゾルバーから取得する project_id（app_id として使用）

ステップ 2：すべてのメモリを取得する

次の内容で get_memories を呼び出します。

• filters={"AND": [{"user_id": "<active_user_id>"}, {"app_id": "<active_project_id>"}]}
• page_size=200

応答がページ分割されている場合（結果に next カーソルが含まれる、または件数が page_size と等しい場合）は、すべてのメモリを取得できるまでページを続けて取得します。

ステップ 3：各メモリを YAML フロントマターブロックとして整形する

各メモリレコードを、次の正確な形式のブロックにします。

---
id: <memory.id>
created_at: <memory.created_at>
type: <memory.metadata.type or "">
confidence: <memory.metadata.confidence or "">
branch: <memory.metadata.branch or "">
files: <memory.metadata.files joined with ", " or "">
categories: <memory.categories joined with ", " or "">
---
<memory.memory or memory content string>

注意：

• --- の区切りは、余分な空白を入れずに独立した行に記述してください。
• files と categories は、カンマ区切りの値を 1 行に記述します。
• 内容の後、次の --- の前に空行を入れてください（読みやすさのため）。
• フィールドが存在しない、または null の場合は、空文字列を記述してください（"null" ではありません）。

ステップ 4：エクスポートファイルを書き込む

出力ファイル名を決定します。

mem0-export-<project_id>-<YYYY-MM-DD>.md

<YYYY-MM-DD> は、本日の日付（UTC）です。

Write ツール（または同等のツール）を使って、整形したすべてのブロックをこのファイルに書き込みます。ファイルは現在の作業ディレクトリに書き込まれます。

ステップ 5：概要を出力する

Exported <N> memories to <filename>

<N> は、書き込んだメモリブロックの合計数です。

エラー処理

• get_memories がエラーを返す場合、またはメモリが 0 件の場合は、次を出力します。

  No memories found for project <project_id>. Nothing exported.
  

• 書き込みに失敗した場合は、エラーをユーザーに報告します。