diff --git a/README.md b/README.md
index acf1955..6066b21 100644
--- a/README.md
+++ b/README.md
@@ -399,6 +399,20 @@ Add to `curator_config.json`:
 - `reserveTokensFloor: 0` — Allow aggressive settings (disables 20k minimum)
 - `memoryFlush.enabled: false` — No silent "write memory" turns
 
+**Known Issue: UI Glitch During Compaction**
+
+When compaction runs, the Control UI may briefly behave unexpectedly:
+- Typed text may not appear immediately after hitting Enter
+- Messages may render out of order briefly
+- UI "catches up" within 1-2 seconds after compaction completes
+
+**Why:** Compaction replaces the full conversation history with a summary. The UI's WebSocket state can get briefly out of sync during this transition.
+
+**Workaround:**
+- Wait 2-3 seconds after hitting Enter during compaction
+- Or hard refresh (Ctrl+Shift+R) if UI seems stuck
+- **Note:** This is an OpenClaw Control UI limitation — cannot be fixed from TrueRecall side at this time.
+
 **Note:** `reserveTokens` and `keepRecentTokens` are Pi runtime settings, not configurable via `agents.defaults.compaction`. They are set per-model in `contextWindow`/`contextTokens`.
 
 ---