Keybinds

Customize bindings in cli.json:

{
  "keybinds": {
    "leader": "ctrl+space",
    "command.palette.show": "ctrl+k",
    "app.exit": ["ctrl+c", "ctrl+d"],
    "app.debug": false
  },
  "leader": {
    "timeout": 1500
  }
}

Use a string for one key:

{
  "keybinds": {
    "command.palette.show": "ctrl+k"
  }
}

Separate alternatives with commas:

{
  "keybinds": {
    "app.exit": "ctrl+c,ctrl+d"
  }
}

Disable a binding with "none" or false:

{
  "keybinds": {
    "app.debug": "none",
    "help.show": false
  }
}

Use an object for event behavior:

{
  "keybinds": {
    "prompt.paste": {
      "key": "ctrl+v",
      "preventDefault": false
    }
  }
}

leader defaults to ctrl+x. <leader> in another binding refers to that key.

{
  "keybinds": {
    "leader": "ctrl+space",
    "model.list": "<leader>m"
  },
  "leader": {
    "timeout": 2000
  }
}

Unknown command IDs are rejected.

Application

Mini

The app.clear command works only in opencode mini. Press ctrl+l to clear the visible screen and draw the prompt again. The terminal keeps the scrollback.

{
  "keybinds": {
    "app.clear": "ctrl+l"
  }
}

Diff Viewer

Press d (diff.switch_source) to choose All, Committed, Uncommitted, or Last turn (inside a session), or select Base to change the comparison branch. Choices are remembered until the TUI exits. Set the initial scope with diffs.source in cli.json.

Scrolling, paging, and start/end shortcuts always control the diff. There is no keyboard focus switch: click files to open them, click folders to expand or collapse them, and use the mouse wheel to scroll the file tree.

Use n / p or alt+down / alt+up (Option on macOS) to move between files. Inside the diff viewer, the Alt shortcuts navigate files rather than session tabs.

Press m to mark a file reviewed and collapse its patch body. In all-files view, press m again to unmark it and reopen the patch. Single-file view automatically advances to the next file when marking reviewed, but stays on the last file rather than wrapping. Unmarking a file never advances.

Right-click a file in the sidebar or its diff heading for Mark complete (or Mark incomplete). This changes the same reviewed state as m. Completing a different file from its menu does not select it or advance the file currently being read.

The shifted diff.help alternatives support terminals that report the Shift modifier when you press ?.

The retired diff.toggle, diff.expand, diff.expand_all, diff.collapse, and diff.switch_focus configuration entries are still accepted, but no longer register shortcuts.

Appearance And Navigation

Sessions

Models And Agents

Session Navigation

Prompt Commands

Input Editing

Composer

Select a running command in the Shell tab and press Enter, or click it, to view captured stdout and stderr. Use ↑/↓, Page Up/Down, or Home to scroll, End to follow new output, and Esc to return without stopping the command. The viewer shows recent output and stays open after exit; output redirected to a file is not included.

Dialogs And Autocomplete

Terminal And Plugins

Which-Key