From 86efd0c9553345ed21311dec89ce3b2ec2dece9d Mon Sep 17 00:00:00 2001 From: root Date: Tue, 24 Feb 2026 21:15:54 -0600 Subject: [PATCH] docs: Add UI glitch note during compaction - Document known Control UI issue during compaction - Explain why it happens (WebSocket sync during summary) - Provide workarounds (wait or hard refresh) - Note this is OpenClaw limitation, not fixable from TrueRecall --- README.md | 14 ++++++++++++++ 1 file changed, 14 insertions(+) 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`. ---