From 8e5e93ec0df1e9c526ce4f149476504c068fa525 Mon Sep 17 00:00:00 2001
From: Wey Gu <weyl.gu@gmail.com>
Date: Wed, 10 Jun 2026 22:47:50 +0800
Subject: [PATCH] docs: document historical Gemini session sync

---
 README.md | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/README.md b/README.md
index c33352b..4225c13 100644
--- a/README.md
+++ b/README.md
@@ -141,6 +141,20 @@ nmem --json t create -t "Gemini CLI Session - auth refactor" -c "Goal: finish th
 nmem status
 ```
 
+For historical backfill, preview first:
+
+```bash
+nmem t sync --from gemini-cli --all-projects --limit 20
+```
+
+Then import:
+
+```bash
+nmem t sync --from gemini-cli --all-projects --apply
+```
+
+Use `-p /path/to/project` instead of `--all-projects` when you only want one project. The command reads local Gemini CLI session files and writes to the Mem server configured in `nmem`.
+
 ## Thread Save vs Handoff
 
 Gemini now supports two separate save paths, and they should stay distinct: