Skip to main content
Monocle lets you remap any action to a key of your choice. Add a keybindings object to your config file and map action names to key strings.

​
How to configure

Add entries to the keybindings object in your config file: 
{
  "keybindings": {
    "quit": "Q",
    "submit": "ctrl+s",
    "scroll_down": "ctrl+j"
  }
}
Each key in the object is an action name; the value is the key string to bind. Only include the actions you want to override — unspecified actions keep their defaults.
Press ? in monocle to see the current effective keybindings, including any overrides you’ve applied.

​
Available actions

ActionDefault keyDescription
upkMove cursor up
downjMove cursor down
topgJump to top
bottomGJump to bottom
half_upctrl+uScroll up half a page
half_downctrl+dScroll down half a page
prev_file[Go to previous file
next_file]Go to next file
selectenterFocus diff pane / toggle directory
focus_swaptabSwitch pane focus
toggle_sidebar\Toggle sidebar visibility
scroll_downJScroll diff down
scroll_upKScroll diff up
scroll_leftHScroll diff left
scroll_rightLScroll diff right
scroll_home0Scroll to column 0
scroll_first_char^Scroll to first non-space character
scroll_end$Scroll to end of line
wrapwToggle line wrapping
toggle_difftCycle diff style (unified / split / file)
tree_modefToggle flat / tree view
collapse_allzCollapse all tree nodes
expand_alleExpand all tree nodes
prev_section{Go to previous sidebar section
next_section}Go to next sidebar section
filter_reviewed/Cycle sidebar filter (all → unreviewed → reviewed)
commentcAdd comment at cursor
file_commentCAdd file-level comment
suggestsSuggest edit at cursor
visualvStart visual (multi-line) selection
reviewedrToggle file reviewed
submitSSubmit review
pausePPause the agent
clear_reviewDClear all comments, plans, and reviewed states
dismiss_outdated—Dismiss outdated comments
toggle_focus_modeFToggle focus mode (hide sidebar, enable wrap)
open_in_editorctrl+gOpen current text in $VISUAL/$EDITOR
base_refbChange base ref
cycle_layoutTCycle layout (auto / side-by-side / stacked)
refreshRForce reload files
help?Show keybindings overlay
quitqQuit monocle
command_mode:Enter command mode
Modal keys — Enter, Esc, and Tab inside overlays — are not configurable.