migrating-memory

メモリの移行

このスキルは、macOS の AI エージェント向け移行アシスタントのように、既存のエージェントから新しいエージェントへメモリブロックを移行するのに役立ちます。

Memory Filesystem（memfs）が必要です

このワークフローは memfs を優先します。memfs が有効な場合は、レガシーのブロックコマンドを使用しないでください。ファイルベースの編集と競合する可能性があります。

確認方法： システムプロンプトに memory_filesystem ブロックがあるか確認してください。system/ ディレクトリを含む /memory/ から始まるツリー構造が表示されていれば、memfs は有効です。

有効にする方法： ユーザーに /memfs enable を実行してもらい、その後 CLI を再読み込みしてください。

このスキルを使用する状況

• 既存のエージェントからメモリを引き継ぐ新しいエージェントを設定している
• 複数のエージェント間でメモリブロックを共有したい
• 古いエージェントを新しいエージェントに置き換える
• 有用なメモリを持つ既存のエージェントがあるとユーザーが話している

移行方法（memfs 優先）

エクスポート → コピー → 同期

推奨される手順は次のとおりです。

1. ソースエージェントの memfs を一時ディレクトリにエクスポートする

   letta memory export --agent <source-agent-id> --out /tmp/letta-memory-<source-agent-id>
   

2. 必要なファイルを自分の memfs にコピーする

   • system/ = 添付されたブロック（常に読み込まれます）
   • ルート = 切り離されたブロック

   例：

   cp -r /tmp/letta-memory-agent-abc123/system/project ~/.letta/agents/$LETTA_AGENT_ID/memory/system/
   cp /tmp/letta-memory-agent-abc123/notes.md ~/.letta/agents/$LETTA_AGENT_ID/memory/
   

3. メモリリポジトリをコミットしてプッシュする

   cd ~/.letta/agents/$LETTA_AGENT_ID/memory
   git add system/project notes.md
   git commit -m "Import memory from source agent"
   git push
   

これにより、引き継ぐ内容を完全に管理でき、すべてを memfs と一貫した状態に保てます。

MemFS が無効な場合

レガシーのブロック単位の CLI コマンドは削除されました。まず MemFS を有効にしてから、上記のエクスポート → コピー → 同期の手順を使用してください。

メモリファイルのコピー中にファイル名が重複した場合は、取り込むファイル名を変更するか、コミットする前に内容を手動でマージしてください。

ワークフロー

ステップ 1：ソースエージェントを特定する

ユーザーにソースエージェントの ID（例：agent-abc123）を尋ねてください。

ID がわからない場合は、finding-agents スキルを呼び出して検索してください。

Skill({ skill: "finding-agents" })

例：「メモリを移行したいエージェントの ID は何ですか？」

例：プロジェクトのメモリを移行する

シナリオ：新しいエージェントとして、「ProjectX-v1」という既存のエージェントからメモリを引き継ぎたい場合。

1. ユーザーからソースエージェントの ID を取得する： ユーザーが agent-abc123 を提示します

2. その memfs をエクスポートする：

   letta memory export --agent agent-abc123 --out /tmp/letta-memory-agent-abc123
   

3. 関連するファイルを自分の memfs にコピーする：

   cp -r /tmp/letta-memory-agent-abc123/system/project ~/.letta/agents/$LETTA_AGENT_ID/memory/system/
   

4. コミットしてプッシュする：

   cd ~/.letta/agents/$LETTA_AGENT_ID/memory
   git add system/project
   git commit -m "Import project memory"
   git push