Memtrace Episode Replay

Overview

Replay the graph diff for one episode (a single git commit or working-tree save). Shows which nodes/edges were added, modified, or removed in that episode — not a multi-episode time-range narrative.

Use get_evolution(mode: "recent") to find episode IDs and timestamps, then drill into a specific episode with this tool.

Episode selector — pick one

There is no from / to / include_working_tree on this tool.

Optional filters (large commits)

Full parameter spec for every Memtrace tool: references/mcp-parameters.md (bundled at the memtrace-skills plugin root).

Steps

1. Find the episode to inspect

From get_evolution:

{ "repo_id": "memdb", "from": "7d ago", "mode": "recent", "limit": 20 }

Each entry has episode metadata including id (use as episode_id) and reference_time.

Or use episode_index: 0 for the newest episode without knowing the UUID.

2. Call get_episode_replay

By episode UUID:

{
  "episode_id": "550e8400-e29b-41d4-a716-446655440000",
  "symbol": "execute",
  "file_path": "src/order/service.rs",
  "kind": "Function",
  "compress": true,
  "limit": 200
}

Newest episode, summary first on large commits:

{
  "repo_id": "memdb",
  "episode_index": 0,
  "mode": "graph_summary"
}

3. Interpret the response

For symbol history across many episodes, use get_timeline instead:

{
  "repo_id": "memdb",
  "scope_path": "OrderService.execute",
  "file_path": "src/order/service.rs"
}

Output

get_episode_replay returns the buckets interpreted in step 3:

{
  "found": true,
  "totals": { "nodes_added": 3, "nodes_modified": 12, "nodes_removed": 1, "edges_added": 7, "edges_removed": 2 },
  "nodes_added": [ /* per-record diffs, paginated per bucket */ ],
  "nodes_modified": [ /* … */ ],
  "edges_removed": [ /* … */ ],
  "page": { "next_cursor": 200 }
}

Common Mistakes