merge

Merge two or more memories that cover the same topic into a single, well-written memory. The originals are removed and replaced by the merged result.

Parameters

Parameter	Type	Required	Description
ids	number[]	Yes	Memory IDs to merge
content	string	No	Custom merged content (auto-generated if omitted)

Return Value

Returns the new merged memory’s ID.

Examples

Merge duplicates

{
  "ids": [12, 15, 23]
}

Merge with custom content

{
  "ids": [12, 15],
  "content": "Auth system uses JWT (RS256) with 15-min expiry. Refresh tokens stored in httpOnly cookies, rotated on each use."
}

Notes

• Original memories are deleted after merge
• Edges from original memories are preserved on the new memory where applicable
• Use this when recall returns multiple memories about the same thing
• Prefer consolidate for larger groups of memories

Related Tools

• consolidate — Replace clusters with summaries
• find_clusters — Discover groups to merge
• update — Edit a single memory