Keyboard shortcuts

Complete reference of keyboard shortcuts for OpenCode’s terminal interface

OpenCode provides vim-style keyboard shortcuts and intuitive key bindings for efficient navigation and control.

Global shortcuts

These shortcuts work throughout the application:

Shortcut	Action
Ctrl+C	Quit application (shows confirmation dialog)
Ctrl+?	Toggle help dialog showing all available shortcuts
?	Toggle help dialog (when not in editing mode)
Ctrl+L	View application logs
Ctrl+S	Switch to a different session
Ctrl+K	Open command palette
Ctrl+O	Open model selection dialog
Ctrl+T	Open theme switcher
Ctrl+F	Open file picker to select files for upload
Esc	Close current dialog or overlay

Press Ctrl+? at any time to see context-sensitive shortcuts based on your current location in the application.

Chat page shortcuts

When in the main chat interface:

Shortcut	Action
Ctrl+N	Create a new session (clears current chat)
Ctrl+X	Cancel current AI operation or generation
i	Focus editor (when not already in writing mode)
Esc	Exit writing mode and focus messages

The i key only focuses the editor when you’re not already typing. This mimics vim’s insert mode behavior.

Editor shortcuts

When the message editor is focused:

Shortcut	Action
Enter	Send message (when editor is not focused)
Ctrl+S	Send message (when editor is focused)
\ + Enter	Add a newline without sending the message
Ctrl+E	Open external editor (set via $EDITOR environment variable)
Esc	Blur editor and focus messages
Ctrl+R + 0-9	Delete attachment at the specified index
Ctrl+R + R	Delete all attachments
Esc	Cancel attachment delete mode

Use Ctrl+E to compose longer messages in your preferred editor like vim or nano. OpenCode creates a temporary markdown file for editing.

Message navigation

Navigate through the conversation history:

Shortcut	Action
PgUp or b	Scroll up one page
PgDn or f	Scroll down one page
Ctrl+U	Scroll up half a page
Ctrl+D	Scroll down half a page

These vim-style navigation keys (b, f, Ctrl+U, Ctrl+D) work throughout the message area for efficient scrolling.

Session dialog shortcuts

When the session switcher is open (Ctrl+S):

Shortcut	Action
↑ or k	Move to previous session
↓ or j	Move to next session
Enter	Select the highlighted session
Esc	Close dialog without switching

Model dialog shortcuts

When the model selection dialog is open (Ctrl+O):

Shortcut	Action
↑ or k	Move up in model list
↓ or j	Move down in model list
← or h	Switch to previous provider
→ or l	Switch to next provider
Enter	Select the highlighted model
Esc	Close dialog without changing model

Use the horizontal navigation (h/l or arrow keys) to quickly browse models from different providers like OpenAI, Anthropic, and Google.

Permission dialog shortcuts

When the AI requests permission to perform an action:

Shortcut	Action
← or Left	Switch to previous option
→ or Right	Switch to next option
Tab	Switch to next option
Enter or Space	Confirm the selected option
a	Allow permission (one time)
s	Allow permission for entire session
d	Deny permission

The permission dialog displays diffs, commands, or URLs for you to review before approving. Use the viewport navigation shortcuts to scroll through large previews.

Command dialog shortcuts

When the command palette is open (Ctrl+K):

Shortcut	Action
↑ or k	Move to previous command
↓ or j	Move to next command
Enter	Execute the highlighted command
Esc	Close dialog without executing

Theme dialog shortcuts

When the theme switcher is open (Ctrl+T):

Shortcut	Action
↑ or k	Move to previous theme
↓ or j	Move to next theme
Enter	Apply the highlighted theme
Esc	Close dialog without changing theme

File picker shortcuts

When the file picker is open (Ctrl+F):

Shortcut	Action
↑ or k	Move to previous file/directory
↓ or j	Move to next file/directory
Enter	Select file or enter directory
Esc	Close file picker without selecting
Arrow keys	Navigate file tree

Logs page shortcuts

When viewing logs (Ctrl+L):

Shortcut	Action
Esc	Return to chat page
Backspace	Return to chat page
q	Return to chat page
PgUp / PgDn	Scroll through logs
Ctrl+U / Ctrl+D	Half-page scroll

Completion dialog shortcuts

When using the @ completion feature:

Shortcut	Action
@	Trigger file/folder completion
↑ or k	Previous completion option
↓ or j	Next completion option
Enter	Select highlighted completion
Esc	Close completion dialog

Type @ in the editor to autocomplete file and folder names, making it easy to reference specific files in your messages.

Vim-style navigation summary

OpenCode embraces vim keybindings for familiarity:

Movement

• j / k for up/down
• h / l for left/right
• Ctrl+U / Ctrl+D for half-page scrolls

Modes

• i to enter insert mode (focus editor)
• Esc to exit insert mode
• ? for help (similar to vim’s :help)

Quick reference table

Print this table for quick reference:

Core actions

Action	Shortcut
Send message	Enter or Ctrl+S
New session	Ctrl+N
Switch session	Ctrl+S
Cancel operation	Ctrl+X
Open commands	Ctrl+K
Change model	Ctrl+O
View help	Ctrl+? or ?

Navigation

Action	Shortcut
Page up	PgUp or b
Page down	PgDn or f
Half page up	Ctrl+U
Half page down	Ctrl+D
Move up	↑ or k
Move down	↓ or j

Dialogs

Action	Shortcut
Close dialog	Esc
Confirm selection	Enter
Switch options	← / → or Tab
Files	Ctrl+F
Themes	Ctrl+T
Logs	Ctrl+L

Permissions

Action	Shortcut
Allow once	a
Allow for session	s
Deny	d
Navigate options	← / → / Tab
Confirm	Enter or Space

Custom keybindings are not currently supported, but shortcuts follow common terminal application conventions and vim patterns for familiarity.