roboomp
c998b5ed1c
When a user had already bound ctrl+q to another action, the new follow-up default still claimed the same chord and whichever handler was registered last in InputController silently won. KeybindingsManager now filters the new Ctrl+Q follow-up default when user config claims that chord for another action, while preserving explicit follow-up remaps. Addresses code review on #1905.
3.7 KiB
Keybindings
Run /hotkeys inside an omp session to see the active chords for your current build. The list reflects any remaps loaded from disk and any bindings added by extensions.
Customize keybindings
User remaps live in ~/.omp/agent/keybindings.yml. The file is a YAML mapping whose keys are keybinding action IDs and whose values are either one chord string or an array of chord strings. It is not read from ~/.omp/agent/config.yml, and there is no nested keybindings object.
app.model.cycleForward: Ctrl+P
app.model.selectTemporary: Alt+P
app.plan.toggle: Alt+Shift+P
Chord names are case-insensitive and use the same notation shown in the UI, such as Ctrl+P, Alt+Shift+P, Shift+Enter, and Ctrl+Backspace.
Set an action to an empty array to disable it:
app.stt.toggle: []
Common action IDs
| Action ID | Default | Meaning |
|---|---|---|
app.model.cycleForward |
Ctrl+P |
Cycle role models forward |
app.model.cycleBackward |
Shift+Ctrl+P |
Cycle role models in temporary mode |
app.model.selectTemporary |
Alt+P |
Pick a model temporarily for this session |
app.model.select |
Ctrl+L |
Open the model selector and set roles |
app.plan.toggle |
Alt+Shift+P |
Toggle plan mode |
app.history.search |
Ctrl+R |
Search prompt history |
app.tools.expand |
Ctrl+O |
Toggle tool-output expansion |
app.thinking.toggle |
Ctrl+T |
Toggle thinking-block visibility |
app.thinking.cycle |
Shift+Tab |
Cycle thinking level |
app.editor.external |
Ctrl+G |
Edit the draft in $VISUAL / $EDITOR |
app.message.followUp |
Ctrl+Q, Ctrl+Enter |
Queue a follow-up message |
app.message.dequeue |
Alt+Up |
Dequeue a queued message back into the editor |
app.clipboard.copyLine |
Alt+Shift+L |
Copy the current line |
app.clipboard.copyPrompt |
Alt+Shift+C |
Copy the whole prompt |
app.clipboard.pasteImage |
Ctrl+V (Alt+V fallback on Windows) |
Paste an image from the clipboard |
app.stt.toggle |
Alt+H |
Toggle speech-to-text recording |
On Windows Terminal, Ctrl+V may be handled by the terminal paste command before omp sees it; use the Alt+V fallback when clipboard image paste appears to do nothing. Windows Terminal also swallows Ctrl+Enter, so the follow-up shortcut also binds Ctrl+Q — the same chord GitHub Copilot CLI uses. If your existing keybindings.yml already assigns Ctrl+Q to another action, that user remap wins and follow-up keeps Ctrl+Enter unless you explicitly bind app.message.followUp.
Older unqualified action names are migrated when keybindings.yml is loaded, but new docs and new configs should use the namespaced action IDs above. Existing keybindings.json files are still accepted and migrated to keybindings.yml; keybindings.yaml is also accepted.