What problem does it solve? Creating per-application keycap overlays for the PolyKybd keyboard requires researching an app's full shortcut set, sourcing licensed icons, converting them to a strict 1-bit channel-packed PNG format, and wiring the mapping entry — a slow, error-prone manual process. ## Core Features & Use Cases - Shortcut research and coverage: Enumerate an app's complete shortcut set from its config files, official docs, or source repository, mapping every modifier chord to its overlay channel. - Licensed icon sourcing with provenance: Pull icons from the app's own repository or free sets like Fluent UI System Icons, recording source URLs and licenses in SOURCES.md for reproducibility. - Deterministic overlay generation: Run scripts/generate_app_overlays.py against a bindings.yaml to produce byte-identical 720x360 overlay PNGs, preview contact sheets, and the overlay-mapping.poly.yaml stanza. - Use Case: Ask to make overlays for Notepad++ and receive researched shortcuts, committed icons with licenses, generated .mods.png files, a preview sheet for approval, and the wired mapping entry. ## Quick Start Ask the assistant to make PolyKybd overlays for an application such as Notepad++ or Blender and approve the generated preview sheet.
