Keyboard and keys

/help prints the live shortcut catalog beside the command list, and /help full adds the complete version; the catalog reads the bindings actually in effect. Application bindings are overridable through keybindings.json, while the editor keeps a fixed Vi-like key set.

ShortcutAction
Arrow keysMove the cursor, or browse history when the composer is empty.
Ctrl+A / HomeMove to the start of the line.
Ctrl+E / EndMove to the end of the line.
Alt+B / Alt+LeftMove one word left.
Alt+F / Alt+RightMove one word right.
Ctrl+] then a characterJump forward to that character.
Ctrl+Alt+] then a characterJump backward to that character.

Editing

ShortcutAction
EnterSend the message.
Shift+Enter / Alt+Enter / Ctrl+JInsert a new line.
Ctrl+W / Alt+BackspaceDelete the previous word.
Alt+DDelete the next word.
Ctrl+UDelete to the start of the line.
Ctrl+KDelete to the end of the line.
Ctrl+YYank deleted text.
Alt+YCycle the yank ring.
Ctrl+-Undo the last edit.
Ctrl+DDelete forward, or quit when the composer is empty.
Ctrl+VPaste clipboard text or an image.
Alt+CCopy the current prompt.
Ctrl+Alt+CCopy the current line.
Ctrl+XEdit the prompt in $VISUAL or $EDITOR.

Transcript

ShortcutAction
PgUp / PgDnScroll one page.
Shift+Up / Shift+DownScroll quickly.
Ctrl+OOpen the group, call, or thought under the viewport, else the tool catalog.
Ctrl+FSearch the current transcript when the composer is empty; n/N step across matches.
Alt+AOpen the Agent Hub; continuable child agents can be steered from their transcript.

Session

ShortcutAction
Esc twiceRewind to an earlier conversation turn.
Ctrl+C onceInterrupt the active turn, or clear the composer.
Ctrl+C twiceExit; a durable session prints an omdsh --resume <session-id> hint.
Ctrl+ZSuspend to the background.
Alt+LReset the terminal display.
Ctrl+RSearch prompt history.
Alt+RRetry the latest human prompt.
Ctrl+P / Alt+PCycle to the next or previous favorite model.
Ctrl+TCycle the current model’s reasoning effort.
/Open slash-command completion.
@ / ./ / ~/Complete file paths.
TabAccept command or path completion.

Overlays

OverlayKeys
Settings (/settings)↑/↓ move between rows, ←/β†’ change a value, Space show or hide a status item, Enter change a value or start moving a status item, Tab/Shift+Tab switch sections, Home/End jump to the edges, Esc/Ctrl+C close.
Copy picker (/copy)↑/↓ or Tab navigate, PgUp/PgDn page, Home/End edges, Enter/Space copy, Esc/Ctrl+C close.
Agent Hub (Alt+A, or ↓ on an empty composer)↑/↓ navigate, Home/End edges, Enter open the child transcript, Tab/←/β†’ switch the inspector pane, PgUp/PgDn scroll, T toggle the tree, Esc/Ctrl+C close.
History search (Ctrl+R)Type to filter, ↑/↓/Tab/PgUp/PgDn/Home/End navigate, Enter select, Esc/Ctrl+C cancel; the query accepts the line-editing keys.
Transcript search (Ctrl+F)Type the query, Ctrl+N/Ctrl+P step while editing, Enter confirm, n/N step across matches, / edit the query, Esc/Ctrl+C close.
Trajectory (/trajectory)↑/↓, Home/End, PgUp/PgDn navigate, Enter open details, Tab/←/β†’ switch sections, / search, n/N and Ctrl+N/Ctrl+P step matches, t collapse turns, c collapse calls, Esc/Ctrl+C close.
Prompts (resume, permission, model, agent, workflow, login, rewind)Type to filter, ↑/↓/Tab navigate, ←/β†’ choose, PgUp/PgDn and Home/End move, Space multi-select, Enter select or submit, Ctrl+J submit, Esc go back or cancel, Ctrl+C cancel.

Custom keybindings

Application bindings live in $OMDSH_HOME/omdsh/keybindings.json (falling back to $DSH_HOME, then ~/.dsh), the same home that stores sessions, settings, and MCP files. The document maps lower-case key ids to action ids:

{
  "ctrl+j": "search-transcript",
  "ctrl+r": "retry"
}

Key ids join modifiers with + (ctrl, alt, shift, super) and spell named keys in lower case (pageup, pagedown, escape, left, right, up, down). Values must be one of the action ids below; an unknown action or a malformed file leaves the shipped binding in place for that entry. Bindings are read once at startup, so restart omdsh after editing the file, and /help then shows the effective keys.

Action idDefault keyEffect
external-editorCtrl+XEdit the prompt in $VISUAL or $EDITOR.
retryAlt+RRun the most recent human prompt again.
paste-clipboardCtrl+VPaste clipboard text or an image.
copy-promptAlt+CCopy the current prompt.
copy-lineCtrl+Alt+CCopy the current line.
inspect-subagentAlt+AOpen the Agent Hub.
cycle-model-forwardCtrl+PCycle to the next favorite model.
cycle-model-backwardAlt+PCycle to the previous favorite model.
cycle-reasoningCtrl+TCycle the current model’s reasoning effort.
toggle-toolsCtrl+OOpen the group, call, or thought under the viewport, else the tool catalog.
scroll-page-upPgUpScroll one page up.
scroll-page-downPgDnScroll one page down.
scroll-fast-upShift+UpScroll quickly up.
scroll-fast-downShift+DownScroll quickly down.
search-historyCtrl+RSearch prompt history.
search-transcriptCtrl+FSearch the current transcript.