The story

Where the keymap comes from and how the project grew.

Inspiration: ZMK and the Cornish ZEN keymap

The keymap style comes from the owner's ZMK keyboard firmware work, in particular the configuration for the 42-key Corne-ish Zen (franken-cornish-zen: 31 layers, home-row mods, combos, Unicode, APL and Greek layers), and the header generator follows zmk_unicode_headers, which turns the Unicode database into named C macros the way GenerateHeaders.jsh turns the USB HID Usage Tables into kp_A and cp_MUTE.

ZMK configurationNachtgespenst
FUN layer: F7 F8 F9 / F4 F5 F6 / F1 F2 F3, F10 on a thumbThe F1-F10 page has the same rows; F11 to F24 follow the same arrangement
Plain, Hyper (LH) and Meh (LM) function layersThe same three families as pages (... HYP, ... MEH), written with lhyp() and lmeh()
KEYPAD, SYM1/SYM2, NAV, VOLUME/CONSUMER, APPLNumpad Full, Symbol Pad, Edit/Nav, Media, App Launch
Home-row mods, combos, mouse, APL, logic, Greek and punctuation layers (Unicode)Not carried over: a touch macro pad has no typing layer and HID has no Unicode
Fixed keycap colours and printed legendsThe macro pad draws keycap colour and legend per tile and per page: colour by kind of key and by modifier, icons, captions and modifier badges
No application layersNew: Maven, Office, Teams, Outlook, PowerPoint, browser and debugger pages, and the Locks page

The full comparison is in the wiki.

Since Claude joined

The project did not start with Claude Code. An earlier version of the firmware was made about a year before, with Gemini in its chat client (the Android app and the browser) and a little help from GitHub Copilot; its keymap style and its header generator come from the owner's ZMK work (see Inspiration). The history of this repository starts on 10 May 2026. On 12 November 2026 the project started working with Claude Code, with a project guide (CLAUDE.md), an overnight plan, and tests that drive the real hardware. The big steps:

The complete list is in the changelog.