Rebinding keyboard shortcuts

Shortcuts are bindings between a key combination and a named action, stored as data like everything else. Rebinding one takes effect immediately, everywhere: the key itself, the command palette hint, the context menus, and the reference sheet all read from the same place.

Recording a shortcut

1. 1

   Open the shortcut settings

   Go to Settings, then Shortcuts. Every action the application knows about is listed, grouped by when it applies.

2. 2

   Select the field you want to change

   The field switches to recording and reads "Press keys". It captures the whole document while recording, so the combination you press cannot trigger the shortcut it is about to replace.

3. 3

   Press the combination

   It is captured and saved immediately. Press Escape instead to cancel without changing anything.

Two small controls sit beside each field: one clears the binding, leaving the action reachable only from the palette, and one restores the original where you have changed it. Anything you have changed is marked so you can see at a glance what has drifted from the defaults.

Scopes

Every binding has a scope, which is the situation it applies in. Scopes are why the same key can mean different things without ambiguity.

Conflicts

Two bindings conflict when they share a key combination and their scopes can be active at once. Global overlaps everything; every other scope only overlaps itself. Conflicts are detected as you record and marked on both bindings, with a note at the top of the page saying how many there are. Nothing stops you saving one, because sometimes you know what you are doing, but only one of them will fire.

Control and Command

A binding recorded with Control also responds to Command, and the reverse, so the defaults work on macOS without changes. If you prefer to see Command written explicitly, record it that way and it will match either key.

Typing is never hijacked

While the cursor is in a text field, the standard editing combinations for select all, copy, cut, paste, undo, and redo are left to the browser even when they are also bound to an action. Select all in the search box selects the text, not every project.

When no key is bound

Clearing a binding does not remove the action. Everything remains in the command palette, which is a complete list of what the application can do in the current context. Actions that need a selection stay visible with the reason shown rather than disappearing, so the palette is also a reliable way to find out why something is unavailable.