feat(desktop): add cross-platform window capture

[Bil0000]

What Changed

• Adds opt-in window capture for macOS, Windows, and Linux Wayland.
• Uses Shift + Shift by default on macOS and Windows. Wayland requires a key chord because its portal does not support modifier-pair shortcuts.
• Checks T3 Code keybindings, common system and app chords, and live OS registration before a normal key chord can be saved on supported desktop sessions.
• Requests macOS Accessibility and Screen Recording only when the user turns Window Capture on and the permission is not already granted. Startup only reads permission state.
• Attaches the image with app name and window title, plus the app icon and accessibility data when they are available.
• Runs accessibility extraction in a short-lived helper, so a native provider crash or timeout falls back to screenshot-only instead of crashing or blocking T3 Code.
• Adds a dedicated settings page, command palette entry, onboarding, platform-aware shortcut key caps, inline sound play controls, capture sound, high-density app icons, an early and gentler visual cue, compact image cards, and one-shot attachment animation.
• Stores pending captures durably and preserves their metadata through drafts, uploads, timeline rendering, and provider input.

Why

Users can add visual and text context from another app without leaving their T3 Code workflow or managing screenshot files. Native behavior stays in the desktop service, while the existing settings, IPC, draft, attachment, and provider paths carry the result.

Platform Details

• macOS and Windows capture the active window. Linux supports Wayland sessions; X11 sessions are unavailable.
• macOS permission prompts only run on the off-to-on settings transition. Already-granted permissions do not prompt again.
• Linux Wayland uses the system portal or the optional GNOME extension and requires a key chord. Portal captures omit accessibility data because the portal does not identify the selected window.
• Outside Wayland, normal key chords are probed through the OS global-shortcut registry. Wayland submits key chords to the desktop portal without claiming that the desktop accepted them. Modifier-only shortcuts cannot be reserved exclusively by any operating system.
• Modifier-pair listeners run only while Window Capture is enabled, require both physical keys to be held together, and stop on disable or app shutdown. macOS uses a permission-free polling helper; Windows and Linux use the isolated Node-mode hook.

Demo

CleanShot.2026-08-31.at.3.17.42.mp4

Testing on macOS

1. Run pnpm dev:desktop, then open Settings > Window Capture.
2. Turn Window Capture on. Permission requests should appear during this off-to-on change, not at startup or on the first capture.
3. In System Settings > Privacy & Security, allow both T3 Code (Dev).app and the terminal app used to run pnpm (such as Terminal, iTerm, or Warp) in:
   • Accessibility — lets T3 Code identify the active window and attach available text.
   • Screen & System Audio Recording (called Screen Recording on older macOS) — lets T3 Code capture the window image.
     If T3 Code is missing, use the + button to select <repo>/apps/desktop/.electron-runtime/T3 Code (Dev).app.
4. Fully restart dev mode after changing either permission: stop pnpm dev:desktop with Ctrl+C, then run it again. If macOS offers Quit & Reopen, still restart the terminal command so the dev server and app start together.
5. Open another app and press both Shift keys together. Confirm T3 Code attaches the image, app name, window title, and available icon and text to the current draft.
6. Turn Window Capture off and on again. Already-granted permissions must not prompt again.
7. Check a custom shortcut, each inline sound play button, Capture flash, Capture animations, and Capture window from the command palette.

Verification

• Focused tests passed for contracts, desktop capture, modifier-pair state, shortcut conflicts, typed IPC, durable delivery, settings support, draft bridge behavior, and timeline rendering.
• Strict focused lint, formatting, and whitespace checks passed.
• Contracts, web, server, and desktop type checks passed.
• Production web, server, and desktop builds passed.
• Electron desktop smoke test passed with isolated state under Xvfb.
• Desktop startup was verified with Window Capture and Capture Flash already enabled.
• Modifier-pair observation and accessibility extraction run outside the Electron main process. Native accessibility crashes, early exits, and timeouts fall back to screenshot-only; source thumbnails remain memory-bounded.
• The capture flash uses renderer-free native windows on macOS and Windows. Linux uses a short-lived renderer fallback. Every flash timer and window is destroyed after playback.
• The desktop bundle keeps uiohook-napi as a packaged runtime dependency with prebuilt macOS, Windows, and Linux binaries for the supported CPU architectures.

Checklist

• One user workflow
• Cross-platform behavior is explicit
• Permission timing is explicit
• UI evidence is included
• Focused tests and builds pass

Generated by GPT-5.6-sol in T3 Code using the Codex harness.

Note

Add cross-platform window capture (SnapShots) to desktop app

• Adds native capture backends for macOS (screencapture), Windows (forked xa11y worker), and Linux (GNOME extension, KDE KWin script, Hyprland Wayland, Niri IPC, and portal fallback)
• Introduces DesktopSnapShot service with IPC handlers for state, setup, permissions, config preview/apply, shortcut registration, and capture delivery; renderer bridge methods and lifecycle events are added to the contracts package
• Adds accessibility extraction via a warm-pooled Electron child process, with bounded text and structured element-tree results scaled to compressed image dimensions
• Adds web settings page at /settings/snap-shot, setup wizard, shortcut recorder with physical-key layout handling, capture animation coordinator, snapshot attachment rendering in composer and timeline, and snapshot source/accessibility metadata in provider prompts
• Builds and stages Linux native capture helpers (KDE, Hyprland) per architecture, bundles the GNOME extension, and disables Windows ASAR smart unpacking so only native binaries are unpacked
• Risk: bumps Electron from 43.4.1 to 44.1.0 (apps/desktop/package.json); patches dbus-next@0.10.2 to use Node native Unix sockets instead of usocket (patches/dbus-next@0.10.2.patch); root route now redirects authenticated desktop sessions requiring setup to /settings/snap-shot (apps/web/src/routes/__root.tsx)

^{Macroscope summarized 07c887d.}

Summary by CodeRabbit

• New Features
  • Added desktop SnapShots for capturing application windows and attaching them to drafts.
  • Added capture setup and preferences for shortcuts, accessibility data, sounds, flash, and animations.
  • Added support across Windows, macOS, and Linux desktop environments, including setup guidance and fallbacks.
  • Added capture metadata, accessibility inspection, previews, and animated delivery into the composer.
  • Added a “Take snapshot” command and dedicated SnapShots settings section.
• Bug Fixes
  • Improved keyboard shortcut recognition and desktop window focusing.
  • Improved capture delivery reliability and attachment metadata preservation.
• Documentation
  • Added user and Linux capture documentation.

[coderabbitai]

Note

Reviews paused

It looks like this branch is under active development. To avoid overwhelming you with review comments due to an influx of new commits, CodeRabbit has automatically paused this review. You can configure this behavior by changing the reviews.auto_review.auto_pause_after_reviewed_commits setting.

Use the following commands to manage reviews:

• @coderabbitai resume to resume automatic reviews.
• @coderabbitai review to trigger a single review.

Use the checkboxes below for quick actions:

• ▶️ Resume reviews
• 🔍 Trigger review

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Team

Run ID: b89b0292-7355-41c8-9420-68f886f4056f

📥 Commits

Reviewing files that changed from the base of the PR and between cbfd64c and 994d8c8.

📒 Files selected for processing (18)

• apps/desktop/src/electron/ElectronWindow.test.ts
• apps/desktop/src/electron/ElectronWindow.ts
• apps/desktop/src/electron/WindowsForegroundFocusWorker.test.ts
• apps/desktop/src/electron/WindowsForegroundFocusWorker.ts
• apps/desktop/src/snapShot/CaptureShortcutConfig.test.ts
• apps/desktop/src/snapShot/LinuxSnapShot.dbus.test.ts
• apps/desktop/src/snapShot/RegionSnapShot.test.ts
• apps/desktop/src/snapShot/RegionSnapShot.ts
• apps/desktop/src/snapShot/SnapShotAccessibilityProcess.test.ts
• apps/desktop/src/snapShot/SnapShotAccessibilityProcess.ts
• apps/desktop/src/snapShot/captureConfigEdit.test.ts
• apps/desktop/src/snapShot/captureConfigKdl.ts
• apps/server/src/provider/Layers/ProviderService.test.ts
• apps/web/src/components/settings/SnapShotSetupDialog.logic.test.ts
• apps/web/src/components/settings/SnapShotSetupDialog.logic.ts
• docs/internals/linux-snap-shot.md
• docs/user/snap-shot.md
• native/kde-snap-shot/src/main.rs

🚧 Files skipped from review as they are similar to previous changes (1)

• native/kde-snap-shot/src/main.rs

Included review availability: Your plan provides up to 10 included reviews per hour; 8 remain after this review.

---

📝 Walkthrough

Walkthrough

This pull request adds a "SnapShots" window-capture feature for the desktop app. It provides shared contracts, native capture backends for macOS, Windows, GNOME, KDE, Hyprland, and Niri, IPC and preload wiring, a GNOME Shell extension, Rust helper binaries, web composer and settings UI, provider prompt handling, packaging, and documentation.

Changes

SnapShot window capture feature

Layer / File(s)	Summary
Shared contracts and schemas packages/contracts/src/ipc.ts, orchestration.ts, settings.ts, *.test.ts	Adds snapshot state, source, accessibility-tree, and shortcut schemas plus DesktopBridge methods used across the feature.
Dependencies and build packaging apps/desktop/package.json, pnpm-workspace.yaml, package.json, scripts/build-desktop-artifact.ts, apps/desktop/vite.config.ts	Adds native capture dependencies, workspace overrides, and packaging rules for capture helpers and worker bundles.
Electron launcher and Linux startup identity apps/desktop/scripts/electron-launcher.mjs, apps/desktop/src/app/*	Updates macOS launcher signing and environment handling. Adds Linux desktop-entry identity resolution used before app readiness.
Desktop IPC handlers, preload bridge, and renderer dispatch apps/desktop/src/ipc/..., apps/desktop/src/window/DesktopWindow.ts, apps/desktop/src/preload.ts, apps/desktop/src/main.ts	Adds snapshot IPC channels and methods, preload bridge methods, bootstrap wiring, and reveal/ready dispatch for captured windows.
Windows foreground focus, icon extraction, and clipboard helpers apps/desktop/src/electron/*, apps/desktop/src/preview/Manager.ts	Adds Windows window activation, an accessibility focus worker, native icon extraction, and asynchronous clipboard writes.
DesktopSnapShot core service and platform capture apps/desktop/src/snapShot/DesktopSnapShot.ts, MacSnapShot.ts, RegionSnapShot.ts, SnapShotAccessibility*.ts, SnapShotTransition.ts, NativeCaptureFeedback.ts, shortcut process files	Implements the core Effect service, macOS/region capture, accessibility extraction, animation overlay, and shortcut worker processes.
Linux capture backends (portal, GNOME, KDE, Hyprland, Niri) apps/desktop/src/snapShot/LinuxSnapShot.ts, PortalCaptureShortcut.ts, GnomeCaptureSetup.ts, KdeSnapShot.ts, HyprlandSnapShot.ts, NiriSnapShot.ts, captureConfigEdit.ts, captureConfigKdl.ts	Adds Linux backend selection, D-Bus portal and GNOME integration, KDE/Hyprland/Niri capture, and config-file shortcut editing.
GNOME Shell extension apps/desktop/gnome-extension/*	Adds the bundled GNOME Shell extension for D-Bus capture and animated feedback on GNOME Wayland.
Native Rust capture helpers (Hyprland, KDE) native/hyprland-snap-shot/*, native/kde-snap-shot/*	Adds standalone Rust binaries and protocol/QML files for Hyprland and KDE window export and feedback overlays.
Web composer capture attachment and animation flow apps/web/src/components/chat/*, apps/web/src/components/desktop/SnapShotCoordinator.tsx, composerDraftStore.ts, apps/web/src/lib/snapShotAnimation.ts, desktopSnapShot.ts	Delivers captures into the composer, animates arrival, renders attachment details, and persists snapshot sources.
Web SnapShots settings and setup wizard apps/web/src/components/settings/SnapShot*.tsx, useSnapShotShortcutRecorder.tsx, keybindings.ts, settingsSearch.ts, ui/wizard-steps.tsx	Adds the SnapShots settings page, setup wizard, shortcut recorder, search entries, and a shared wizard-steps component.
Provider prompt handling and client settings persistence apps/server/src/provider/Layers/ProviderService.ts, Normalizer.ts, apps/web/src/hooks/useSettings.ts	Compacts accessibility trees in provider prompts, persists snapshot source metadata, and fixes settings-persistence ordering.
Documentation docs/internals/linux-snap-shot.md, docs/user/snap-shot.md, docs/README.md	Adds internal Linux capture design docs and a user-facing SnapShots guide.

Estimated code review effort: 5 (Critical) | ~180 minutes

Merge Risk: 🟡 Moderate · up to 994d8

SnapShots adds cross-platform capture and provider context handling, but unresolved risks remain around untrusted captured text reaching provider input, captures attaching to the wrong draft, stalled native operations, and platform shortcut or build behavior. These issues should be resolved or explicitly accepted before merge.

Sequence Diagram(s)

sequenceDiagram
  participant User
  participant DesktopSnapShot
  participant LinuxSnapShot
  participant CaptureBackend
  participant SnapShotCoordinator
  participant ComposerDraftStore

  User->>DesktopSnapShot: trigger shortcut or command
  DesktopSnapShot->>LinuxSnapShot: captureLinuxWindow(appId)
  LinuxSnapShot->>CaptureBackend: capture via portal/GNOME/KDE/Hyprland/Niri
  CaptureBackend-->>LinuxSnapShot: PNG plus window metadata
  LinuxSnapShot-->>DesktopSnapShot: LinuxWindowSnapshot
  DesktopSnapShot->>DesktopSnapShot: persistCapture(png, metadata)
  DesktopSnapShot->>SnapShotCoordinator: dispatch snap-shot-ready
  SnapShotCoordinator->>DesktopSnapShot: listPendingSnapShots / readSnapShot
  SnapShotCoordinator->>ComposerDraftStore: addImage(source)
  SnapShotCoordinator->>DesktopSnapShot: acknowledgeSnapShot(id)

Loading

sequenceDiagram
  participant WebSettingsUI
  participant DesktopBridge
  participant DesktopSnapShot
  participant GnomeCaptureSetup
  participant PortalCaptureShortcut

  WebSettingsUI->>DesktopBridge: setupSnapShot(action)
  DesktopBridge->>DesktopSnapShot: setup(action)
  DesktopSnapShot->>GnomeCaptureSetup: perform(install-extension)
  GnomeCaptureSetup-->>DesktopSnapShot: extension state
  DesktopSnapShot->>PortalCaptureShortcut: configure()/bind shortcut
  PortalCaptureShortcut-->>DesktopSnapShot: PortalShortcutState
  DesktopSnapShot-->>DesktopBridge: DesktopSnapShotState
  DesktopBridge-->>WebSettingsUI: updated snapshot state

Loading

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Docstring Coverage	⚠️ Warning	Docstring coverage is 6.75% which is insufficient. The required threshold is 80.00%. Docstring coverage is scoped to functions touched by this diff. Analyzed 163 functions across 92 files. (2 skipped:…	Write docstrings for the functions missing them to satisfy the coverage threshold.

✅ Passed checks (4 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title clearly summarizes the primary change: cross-platform desktop window capture.
Description check	✅ Passed	The description explains what changed, why it changed, platform behavior, UI impact, testing, and verification. It includes demo evidence and checklist coverage, so it is sufficiently complete despite…
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

Full details: Docstring Coverage

Explanation

Docstring coverage is 6.75% which is insufficient. The required threshold is 80.00%. Docstring coverage is scoped to functions touched by this diff. Analyzed 163 functions across 92 files. (2 skipped: 2 unsupported.)

✨ Finishing Touches 💡 1

🛠️ Fix failing CI checks 💡

• Create stacked PR
• Commit on current branch

🧪 Generate unit tests (beta)

• Create PR with unit tests

---

_{Comment @coderabbitai help to get the list of available commands.}

[macroscopeapp]

Reviewed the new Effect service (apps/desktop/src/windowCapture/DesktopWindowCapture.ts), its IPC methods, layer wiring, and contract additions. Module shape (namespace imports, Context.Service with inline interface, exported make/layer, dependencies acquired via yield*) follows the conventions; the Effect.runPromiseWith bridge for the Electron globalShortcut callback matches the existing desktop native-callback pattern. Two error-modeling issues below.

^{Posted via Macroscope — Effect Service Conventions}

[macroscopeapp]

UI consistency review

Two findings, both in the new window-capture UI.

1. apps/web/src/index.css introduces a global rule keyed on the class trio .animate-in.fade-in.zoom-in-95, which does not exist as a utility in this project. The repo's established pattern (see ComposerStashBadge/prompt-stash-count-enter) is keyframes in index.css plus an animate-[…] utility at the owner. As written, the unlayered global rule wins over Tailwind's layered animate-none, so the call-site motion-reduce:animate-none is inert (reduced motion only works because of the duplicated media query), duration-200 never affects the animation, and any future element combining those class names silently inherits this animation.

2. WindowCaptureSettings records a shortcut on a Button without the data-keybinding-capture opt-out that app-level shortcut handlers check, so global capture-phase handlers (e.g. sidebar.toggle in AppSidebarLayout) consume the keypress before the recorder sees it.

Details inline.

^{Posted via Macroscope — UI Consistency}

[macroscopeapp]

Approvability

Verdict: Not approved

Macroscope's review found this PR not approvable — This PR introduces a large cross-platform window-capture product workflow with new native helpers, desktop integrations, persistence, provider routing, UI, and release packaging. It also changes product defaults and static-analysis directives, making the scope and operational risk unsuitable for automatic approval.

Not approved because:

• Per-review cost limit exceeded (workspace setting). Approvability relies on correctness review in order to determine eligibility

^{Review your spending limits in Billing settings, or comment @macroscope-app review this PR to bypass the limit and review now. You can add or adjust custom eligibility rules. Learn more.}

[macroscopeapp]

Window capture UI review: one new finding on WindowCaptureOnboardingDialog (dialog body bypasses the DialogPanel contract). The three findings from the previous run (index.css .animate-in.fade-in.zoom-in-95 global override, the matching ChatComposer class string, and the missing data-keybinding-capture on the shortcut recorder) are unchanged in this head commit and are not re-posted.

^{Posted via Macroscope — UI Consistency}

[macroscopeapp]

UI consistency review of the web-side window capture surfaces. Four findings, all on newly added lines; the three items flagged in the previous run (global .animate-in override, call-site animation ownership, and the missing data-keybinding-capture marker) are resolved in this revision.

^{Posted via Macroscope — UI Consistency}

[macroscopeapp]

UI consistency review of the window-capture web surfaces. Two findings on the new settings page; the composer/timeline attachment cards, the onboarding dialog, the keyframe ownership, and the command palette action all follow the existing primitives and conventions.

^{Posted via Macroscope — UI Consistency}

[macroscopeapp]

Reviewed the web UI surface of this feature (composer/timeline capture cards, capture settings page, onboarding dialog, command palette entry, keyframe ownership). The earlier findings on the window-capture-card-enter keyframe ownership, data-keybinding-capture, DialogPanel composition, capability gating of the onboarding dialog, and the disabled state of the sound/flash/animation switches are all resolved. Two remaining items below.

Still open from earlier reviews (not re-posted): the shortcut recorder still preventDefault()s Tab so focus cannot leave the button, and WindowCaptureAttachmentDetails still anchors its title to text-foreground while rendering on bg-background/70 inside the text-message-foreground bubble.

^{Posted via Macroscope — UI Consistency}

[macroscopeapp]

One consistency finding on the new window-capture web code. Previously flagged items (recorder Tab handling, data-keybinding-capture, disabled-state parity for the feedback switches, capability gating on the onboarding dialog, DialogPanel composition, and the named window-capture-card-enter keyframes) all look resolved at this head.

^{Posted via Macroscope — UI Consistency}

[macroscopeapp]

Reviewed the changed web UI surfaces (window-capture settings page, onboarding dialog, composer/timeline attachment cards, command palette entry, index.css keyframe). Earlier rounds' items (shared focus-event constant, DialogPanel composition, data-keybinding-capture, Tab handling, named keyframe animation, uniformly gated switches) all look resolved. Two remaining consistency points on the new settings page.

^{Posted via Macroscope — UI Consistency}

[macroscopeapp]

Two findings on the settings surface introduced/changed here. The composer and timeline capture cards, the extracted SettingsUnavailableGroup, the keyframe ownership, and the onboarding dialog composition all look consistent with the existing primitives now.

^{Posted via Macroscope — UI Consistency}

[macroscopeapp]

One consistency finding on the new window-capture attachment card; everything else (settings layout group, dialog composition, keyframe ownership, palette action) matches the existing contracts.

^{Posted via Macroscope — UI Consistency}

[macroscopeapp]

One error-modeling finding on the new DesktopWindowCapture service. The rest of the service (namespace imports, make/layer exports, dependency acquisition via yield*, native-callback runPromiseWith boundary, structured tagged error with cause) follows the conventions.

^{Posted via Macroscope — Effect Service Conventions}

[macroscopeapp]

Reviewed the Effect service changes in apps/desktop/src/windowCapture/DesktopWindowCapture.ts, the new IPC methods, layer wiring in main.ts, and the contracts schemas. Service definition order, namespace imports, make/layer export shape, and dependency acquisition via yield* Foo.Foo all look correct. Two error-modeling conventions are still not met in the capture error path.

^{Posted via Macroscope — Effect Service Conventions}

[juliusmarminge]

Pushed seven commits on top of ae6cc08 addressing the audit:

• Palette action removed. It skipped the enabled check, so a fresh install with SnapShots off could get the macOS Screen Recording prompt from the palette, and it needed a second capture target plus a window hide/show dance. The shortcut is now the only way in (aafd0d1).
• Nothing native on the startup path. get-windows and every dbus-next module were static imports of the snapshot service. They are dynamic at their use sites now, and the pure Linux helpers moved to linuxCaptureSession.ts so nothing D-Bus-flavoured is statically reachable from main.ts. On Windows the xa11y focus worker starts on the first capture reveal instead of at construction, and only capture reveals take the ffi-rs foreground path (7bc2113, c4000a3).
• Unrelated setting saves no longer restart the shortcut hook. Only the enabled flag, the accessibility toggle, and the shortcut itself trigger re-registration.
• Renderer events are sent before the reveal, and the reveal is best effort, so a foreground refusal on Windows no longer drops or duplicates the message.
• Release CI caches the KDE and Hyprland helper binaries and only installs Rust when a cache misses. The Rust CI job formats and tests all three crates (8dd75a3).
• Docs cut from 685 lines to about 170 (5e0bb76).
• Typed event channel replaces the five snap-shot-* menu-action strings (bfb2e42).
• Tests: dropped palette, hidden-window, icon-fallback-order, error-copy, and executeJavaScript source-string assertions. Added coverage that an unrelated setting keeps the shortcut and that capture fails closed while disabled without touching native APIs.

The Electron 44 bump is split out as #10591 so this PR can rebase onto it. Still open from the audit: the dbus-next abstract-socket break from the usocket override, and the dependency footprint (get-windows and uiohook-napi are candidates for small vendored replacements; WindowsWindowIcon.ts can drop in favour of app.getFileIcon).

Focused tests: 1005 passed across desktop snapshot, IPC, electron, window, web coordinator, settings, palette, and contracts. Desktop, web, and contracts typecheck clean. No live capture or browser verification.

Model: Claude Fable 5.1. Harness: Claude Code.

[juliusmarminge]

Two more commits from the dependency audit:

• e4c5de0 patches dbus-next so unix:abstract= session buses connect through net now that usocket is removed. Smoke-tested: an abstract address no longer throws on require, it connects and gets a normal socket error when no daemon is present.
• 7520bc9 drops get-windows and uiohook-napi and moves every xa11y load out of the main process.
  • Foreground window lookup is now ActiveWindow.ts: an osascript JXA call on macOS (verified against this machine, it returns the frontmost app's layer-0 window with bundle id and path) and seven Win32 calls through the ffi-rs loader we already ship on Windows.
  • The Windows modifier-pair listener polls GetAsyncKeyState at 20 Hz in the same forked child, mirroring the macOS design. No system-wide keyboard hook.
  • Windows region capture runs in a new forked RegionSnapShotWorker with a warm standby and a deadline. The in-process UIA focus fallback is gone; the worker thread already covered that path. WindowsWindowIcon.ts is dropped in favour of app.getFileIcon.
  • Net: two fewer runtime deps, no install-time build scripts left for the feature, and the built main.cjs has zero static references to xa11y, dbus-next, ffi-rs, get-windows, or uiohook.

Remaining runtime deps for the feature are @crowecawcaw/xa11y (children and worker only) and ffi-rs (already on main via fff-node), plus dbus-next on Linux. 742 focused tests pass; desktop, web, and scripts typecheck clean. The desktop bundle builds with the three worker entries. Windows and Linux paths are tested with fakes only; I have no Windows or Linux box to run them live.

Model: Claude Fable 5.1. Harness: Claude Code.