rtlzeromemory/rezi-keybindings

When to use

Use this skill when:

• Adding keyboard shortcuts to a Rezi app
• Setting up chord bindings (multi-key sequences like g g)
• Creating modal input modes (e.g., vim-style normal/insert)
• Adding a keybinding help widget

Source of truth

• packages/core/src/keybindings/ — keybinding system implementation
• packages/core/src/widgets/ui.ts — ui.keybindingHelp() widget

Steps

1. Define key bindings using app.keys():

   app.keys({
     "q": () => shutdown(),
     "Ctrl+s": () => save(),
     "g g": () => scrollToTop(),  // chord binding
   });
   

2. For modal modes, register mode maps with app.modes():

   app.modes({
     "edit-mode": {
       "Escape": () => exitEditMode(),
       "Ctrl+s": () => saveAndExit(),
     },
   });
   

3. Add discoverability with ui.keybindingHelp():

   ui.keybindingHelp(app.getBindings())
   

Overlay shortcut hints

Dropdown and CommandPalette shortcut fields are currently display/search hints.

• routeDropdownKey(...) handles navigation keys (Up, Down, Enter, Space, Escape).
• CommandPalette shows shortcut text and uses it in filtering, but does not auto-bind combos.
• Register real shortcut combos explicitly with app.keys() or app.modes().

Key format reference

| Format | Example | |--------|---------| | Single key | "q", "Enter", "Escape" | | Modifier | "Ctrl+s", "Alt+x", "Shift+Tab" | | Chord | "g g", "g t" (space-separated) |

Verification

• Keys trigger correct actions
• No conflicts in the same mode
• Chords complete correctly after all keys pressed