OpenParable
Skip to content
← Back to skills

Rezi Keybindings

Apps & Automation
rezi-keybindings

Rezi Keybindings is an Agent Skill for apps & automation published in the RtlZeroMemory/Rezi repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Set up keyboard shortcuts and chord bindings for a Rezi app. Use when adding hotkeys, key combos, or modal input modes.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/RtlZeroMemory/Rezi/blob/HEAD/.claude/skills/rezi-keybindings/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/rezi-keybindings, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

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

FormatExample
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