rezi-keybindings

name: rezi-keybindings description: Set up keyboard shortcuts and chord bindings for a Rezi app. Use when adding hotkeys, key combos, or modal input modes. user-invocable: true allowed-tools: Read, Glob, Grep, Edit, Write argument-hint: "[key-combo or mode-name]" metadata: short-description: Set up 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

Verification

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