The T3 logo appears in Linux’s application chooser
Result: verified
The chooser now shows T3 Code’s actual logo instead of Linux’s generic executable icon.
This local change builds on PR #8673 at 21a30a5ec4. The icon change is now committed in 5262e13b1d, with diagnostic follow-ups through 8b5b5b73ec and pushed to PR #8673. No merge was performed.
Final review status: CI and CodeRabbit pass on 8b5b5b73ec; all review threads are resolved. Macroscope correctness and Effect conventions pass. Macroscope declined automatic approval because OAuth callback registration and startup side effects warrant human review. GitHub reports CLEAN and MERGEABLE; the PR remains unmerged.
Before & after
Actual native GTK 3 chooser screenshots on an isolated X display, using the real registration service and filesystem/process services. The harness sets the dialog heading and uses a harmless executable in place of launching T3 Code. The screenshots are not mockups.
Verification
| Check | Result |
|---|---|
| Native chooser | Real T3 logo visibly present; handler remains selectable. |
| AppImage mount disappears | Persistent icon remains byte-for-byte equal to the bundled production logo; chooser displays it after simulated mount removal. |
| Custom XDG directory containing spaces | Absolute Icon path resolves and displays correctly. |
| Repeat registration | Desktop-entry modification time is unchanged. |
| Discovery | GIO still lists T3 Code as default, registered and recommended. |
| Pre-ready registration | Tests verify icon and entry are ready before startup yields. |
| Icon copy fails | Both early and normal registration continue. The existing generic-icon fallback remains available. |
| Focused automated tests | 16 tests pass across DesktopLinuxUrlHandler and DesktopPreReadyPlatform. |
| Desktop typecheck, targeted lint, formatting, diff check | All pass. |
No packaged Electron build or complete OAuth login was exercised. The pushed icon commit has its own CI run; check GitHub for the current result. For the original PR verification, see the original PR report.
What changed locally
The packaged Linux handler copies its bundled PNG to $XDG_DATA_HOME/icons/com.t3tools.T3Code.desktop.png (normally under ~/.local/share) and includes that absolute path in the desktop entry’s Icon= field. This survives AppImage unmounting. The early registration and normal registration use the same destination; normal registration retries the copy. Icon-copy failures do not block URL registration.
Four files changed: DesktopLinuxUrlHandler.ts, DesktopPreReadyPlatform.ts and their existing test files. No new assets or dependencies were added.
Scope: packaged Linux desktop registration. Web, mobile, providers, contracts, remote connections and macOS/Windows behavior are unchanged; unpackaged development keeps its existing entry behavior. This cosmetic change does not need user documentation.
Risk: low. A missing or unwritable icon falls back to the generic appearance. The main remaining verification gap is running the full packaged app; the native chooser and real filesystem behavior are verified.
Temporary X displays were stopped and test fixtures and local screenshot files are removed after publication. Live T3 data and the user’s actual URL-handler defaults were not changed. The source edits are committed locally and pushed to the existing PR.