← ClaudeAtlas

qol-plugin-keyremaplisted

Use when working on the qol-tray key remap plugin. Covers config-to-rule resolution, native event interception, per-app policy, hot reload, daemon lifecycle, editor integration, and target adapters.
qol-tools/qol-skills · ★ 0 · AI & Automation · score 62
Install: claude install-skill qol-tools/qol-skills
# qol-plugin-keyremap Key Remap converts declarative config rules into native input-event transformations. `plugin.toml` owns runtime/platform availability, `qol-config.toml` owns rule shapes/defaults, and source/tests own implemented rule semantics. ## Contract ownership - Never restate the manifest action, platform, daemon, or menu inventory here. - A config rule kind exists only when contract schema, Rust raw/resolved models, native callback behavior, editor schema/components, and tests agree. - If config references a named runtime action/query, declare it in `qol-runtime.toml`; otherwise do not add an empty runtime contract. - Run plugin tests and `qol check` after contract changes. ## Source ownership | Path | Responsibility | |---|---| | `src/main.rs` | Thin process entrypoint; collect arguments and delegate to the selected platform adapter. | | `src/platform/mod.rs` | Single target-selection boundary. | | `src/platform/macos/app/` | Process actions, daemon lifecycle, contract-backed config, rule resolution, and semantic diffs for the supported adapter. | | `src/platform/macos/app_tracker.rs` | Live frontmost-application tracking. | | `src/platform/macos/tap.rs` | CGEventTap ownership and native event transformation. | | `src/platform/linux/`, `src/platform/windows/` | Explicit unsupported-target launch behavior needed for cross-compilation. | | `qol-hotkeys::macos_keycode` | Shared key name/code translation; do not recreate a plugin-local forwarding module. | | `u