Skip to main content
Herm actions use named key chords. The default leader prefix is Ctrl+X; press it first, then press the action key. Use /keys to inspect or remap shortcuts. Changes persist in ~/.hermes/herm/tui.json.

Opening the keybinding editor

1

Open /keys from the composer

Type /keys in the composer and press Return. The keybinding editor opens as an overlay.
2

Browse and select an action

Use the arrow keys to scroll through the action list. Each row shows the action name, its current chord, and a short description.
3

Press the new chord

Highlight the action you want to change and press the key or sequence you want to assign. Herm records the chord immediately.
4

Changes save automatically

Your rebindings are written to ~/.hermes/herm/tui.json as soon as you make them. There is no separate save step.
Press F1 to open a read-only shortcut reference.

The leader key

The leader key is a two-stroke prefix that gates a large set of session and UI actions. It works like Vim’s leader or tmux’s prefix: you press the leader first, release it, then press the action key. The default leader is Ctrl+X. For example, the default binding to open a new session is <leader>n, which means: press Ctrl+X, then press n. The leader key itself is rebindable: change the leader action in /keys to any chord you prefer. A popular alternative is Ctrl+\ for users who find Ctrl+X conflicts with their readline habits.
Secondary alternates are shown in parentheses throughout the table below. For example, editor.open advertises <leader>e but also accepts Ctrl+G as a fallback so existing muscle memory keeps working while you learn the leader pattern.

OpenCode-compatible bindings

If you are migrating from OpenCode, Herm ships a compatible binding preset. Run /keys and look for the OpenCode import option to apply those chords in one step without remapping each action individually.

Default keybindings

The following reference is generated from src/keys/catalog.ts in the Herm source repo.

Global

List

Dialog

Composer

Sessions

Agents

Config

Eikon

Where rebindings are saved

Customized chords are stored in:
You can inspect this file to see only your overrides: actions you have not changed are not written, so the file stays small. Deleting an entry from the file reverts that action to its default chord on the next launch.