From f53d2553d668647df8b391fa84d78dc56fb1cecd Mon Sep 17 00:00:00 2001 From: felixzsh Date: Tue, 11 Aug 2026 14:18:05 -0500 Subject: [PATCH] Document the stale-component caveat after plugin updates --- README.md | 10 ++++++++-- 1 file changed, 8 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index ed13ef8..5002fe6 100644 --- a/README.md +++ b/README.md @@ -90,8 +90,14 @@ omarchy-shell shell rescanPlugins The shell's enable flow persists the bar layout before it registers new third-party widgets (a shell-side ordering detail, not specific to this -plugin); a rescan registers them. A full `omarchy restart shell` also -works. +plugin); a rescan registers them. + +**One caveat**: the plugin reload pipeline is debounced and can leave a +stale component in the running shell — especially after rapid uninstall + +reinstall cycles or editing plugin files. If a change you deployed does not +take effect (old behavior persists), run `omarchy restart shell` once; that +unconditionally loads everything from disk. This applies to any third-party +plugin, not just this one. ## Behavior