From 6cc48b3266377a3b3fffd175809568f1ce914325 Mon Sep 17 00:00:00 2001 From: Josh Knapp Date: Thu, 27 Aug 2026 15:53:19 -0700 Subject: [PATCH] Document the Wayland icon-cache-needs-relogin gotcha MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit A user hit this after installing the new Arch/CachyOS package (triple-c#34): icon missing in the app menu, taskbar, and titlebar alike, with no error in the app's own log. Root cause has nothing to do with the app or its packaging — GNOME/KDE cache the installed-app list and resolved icons in the shell process's memory at startup, and Wayland has no equivalent to X11's soft shell-restart trick to force a live reload. Logging out and back in fixed it for them. --- HOW-TO-USE.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/HOW-TO-USE.md b/HOW-TO-USE.md index 43b6955..8975bb4 100644 --- a/HOW-TO-USE.md +++ b/HOW-TO-USE.md @@ -1554,3 +1554,9 @@ cp ~/.claude.json ~/.claude.json.bak && jq 'with_entries(select(.key | startswit ``` This backs up your config and removes the corrupted marketplace entries. Claude Code will re-download them cleanly on the next startup. + +### App Icon Missing After Installing (Linux) + +If Triple-C's icon shows as generic or blank right after installing — in the app menu, taskbar, and window titlebar alike — **log out and back in.** + +Desktop shells (GNOME Shell, KDE Plasma) cache the list of installed apps and their resolved icons in memory when the shell starts, for performance. A freshly installed package's icon files land on disk correctly and its install hooks do rebuild the on-disk icon cache, but an already-running shell doesn't always notice — on X11 there used to be a way to soft-restart just the shell (GNOME's Alt+F2 → `r`) to force a reload, but under Wayland the shell *is* the compositor, so restarting it means ending the session. Logging out and back in starts a fresh shell that reads the current on-disk state, which picks the icon up.