aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorDanilo M. <danix@danix.xyz>2026-10-07 19:21:33 +0200
committerDanilo M. <danix@danix.xyz>2026-10-07 19:21:33 +0200
commit784e3c17548560419b89c9f92ef2c38bad43f093 (patch)
tree55ea1e4b515def4d55bdef3e0032f5087364bbc4
parenta55464e179a3f82aa46866564878ad35e11e0ae5 (diff)
downloadquickshell-784e3c17548560419b89c9f92ef2c38bad43f093.tar.gz
quickshell-784e3c17548560419b89c9f92ef2c38bad43f093.zip
docs(agents): a branch switch can drop a component until restart
Seen merging the island: the shell reloaded while desktop/island/ did not exist, and stayed without it after the fast-forward restored the files. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
-rw-r--r--AGENTS.md7
1 files changed, 7 insertions, 0 deletions
diff --git a/AGENTS.md b/AGENTS.md
index a6fb434..2d7c950 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -387,6 +387,13 @@ correct and a fresh `qs` process rendered it. Force the rescan by changing a
file that imports the directory (`desktop/shell.qml`), or restart the shell.
Touch alone does not reload: the content must change.
+Switching git branches under a running shell can drop a component until a
+restart. Merging the island branch meant a moment on master without
+`desktop/island/`; the shell hot-reloaded then, logged `Ignoring unresolvable
+import ".../desktop/island"`, and kept running without the island after the
+files came back, because a reappearing directory is not re-indexed. Restart
+the affected component after any checkout that adds or removes a directory.
+
Hot reload does **not** follow a symlink either. Editing `shared/Notify.qml`
left both running shells on the old `sanitize`, while an edit to
`notifications/NotificationBalloon.qml` in the same pass did reload, so the