qol-langs

Use when writing gpui UI code in this workspace. Verified patterns and gotchas for gpui 0.2 + gpui-component, built through hands-on exploration — NOT a generic gpui reference. For canonical gpui docs, use context7 (though coverage is limited; this skill is the better source for real-world patterns). Covers views, input, lists, focus, window management, testing.

Use when a qol plugin (alt-tab, launcher, window-actions) must bring ANOTHER app's window to the front on macOS, or make its own popup key. Covers why NSRunningApplication.activate is inert on macOS 14+, why SkyLight `_SLPSSetFrontProcessWithOptions` is necessary but silently ignored against actively-front apps, the `kAXFrontmost` app attribute that actually foregrounds a fighting app, the generation-guarded re-assert loop that beats the picker-teardown race, AXRaise/unminimize ordering, reading the true frontmost window via CGWindowList, dlopen-ing a private framework, and the click-gesture / modifier-drop focus pitfalls. Built from a reproduced alt-tab focus bug, not generic docs. For our own popup's focus use gpui-conventions ("Eagerly stealing OS window focus"); this skill is about foregrounding a foreign app.

Use when writing Preact + htm code in this workspace. Workspace-specific patterns and gotchas (no JSX, no build step, htm tagged templates from `lib/html.js`, keyboard-first hard rule, icon component extraction, toast/dissolve helpers, focus trapping, custom inputs, router guards, provider unmount/remount) — NOT a generic Preact reference. For canonical Preact docs, use context7. qol-tray-specific component hierarchy (Surface trait, plugin-config fields) lives in `qol-tray-ui-systems`.

Use when writing Rust in this workspace. Workspace-specific style and gotchas (error handling, filesystem, process management, cross-platform code layout) — NOT a generic Rust reference. For canonical Rust/library docs, use context7 instead. Plugin-specific and qol-tray-specific Rust gotchas live in their own skills (`qol-plugin-*`, `qol-tray-core`, `qol-tray-rust`, `qol-arch-code`, `qol-arch-cross-platform`).