Keyboard shortcuts

Press ← or → to navigate between chapters

Press ? to show this help

Press Esc to hide this help

Terminal Features & Keyboard Shortcuts

Consolidated reference for all terminal behaviors, keyboard shortcuts, and configurable features.

Keyboard Shortcuts

Terminal Management

ShortcutActionNotes
Cmd+TNew terminal tab
Cmd+WClose tab/paneCloses active split pane, or tab if no split
Cmd+Shift+TReopen closed tabRestores last 10 closed tabs
Cmd+1–9Switch to tab NFirst 9 tabs only
Ctrl+TabNext tabNSEvent monitor on macOS
Ctrl+Shift+TabPrevious tabNSEvent monitor on macOS

Terminal Content

ShortcutActionNotes
Cmd+LClear terminalSends Ctrl+L to shell (clear screen)
Cmd+KClear scrollbackClears entire scrollback buffer (iTerm2 convention)
Cmd+CCopy selection
Cmd+VPaste
Cmd+FFind in terminalSearch overlay with match highlighting
Cmd+GFind next match
Shift+Cmd+GFind previous match

Scrolling

ShortcutAction
Cmd+HomeScroll to top of scrollback
Cmd+EndScroll to bottom
Shift+PageUpScroll one page up
Shift+PageDownScroll one page down
Wheel / two-fingerScroll the scrollback (smooth)
Shift+WheelForce scrollback scroll, never sent to the app

Wheel vs. mouse-reporting apps. When an app enables mouse tracking, the wheel is forwarded to it as SGR mouse codes only in the alternate screen (vim, lazygit, htop — they own the viewport and have no scrollback). In the main screen the wheel always scrolls TUIC’s scrollback, even if the app enabled mouse mode — that history belongs to the terminal, not the app, so only the terminal can scroll it. This is why an inline app that turns on mouse reporting without switching to the alt screen (e.g. grok --no-alt-screen) still scrolls normally. Hold Shift to force scrollback scrolling regardless of mouse mode (consistent with Shift bypassing mouse reporting for clicks/selection).

Split Panes

ShortcutActionNotes
Cmd+\Split verticallySide-by-side, max 4 panes
Cmd+Alt+\Split horizontallyStacked
Cmd+Shift+EnterMaximize/restore paneToggle zoom on active pane
Alt+Arrow Left/RightNavigate vertical panes
Alt+Arrow Up/DownNavigate horizontal panes

Panels

ShortcutAction
Cmd+[Toggle sidebar
Cmd+,Settings
Cmd+EFile browser
Cmd+Shift+MMarkdown panel
Cmd+Alt+NNotes/ideas panel
Cmd+OOpen file picker
Cmd+NNew file (picker for name + location)
Cmd+JTask queue
Cmd+BQuick branch switch
Cmd+GBranches tab
Cmd+Shift+DGit operations panel
Cmd+Shift+EError log
Cmd+Shift+AActivity dashboard
Cmd+Shift+WWorktree manager
Cmd+Shift+MMCP servers popup
Cmd+Shift+GDiff scroll view
Cmd+?Help panel
ShortcutAction
Cmd+PCommand palette
Cmd+Shift+KPrompt library
Cmd+RRun saved command
Cmd+Shift+REdit saved command
Cmd+Shift+FSearch file contents
Cmd+Ctrl+1–9Quick branch switch (hold Cmd+Ctrl, press number)

Zoom

ShortcutAction
Cmd+= / Cmd++Zoom in
Cmd+-Zoom out
Cmd+0Reset zoom

Terminal Behaviors

Copy on Select

Auto-copies selected text to clipboard when text is selected in terminal. Configurable in settings (copy_on_select, default: on).

URL Click

Cmd+Click on URLs in terminal output opens them in the system browser. URL detection handled by the native terminal link parser.

File Path Click

Clickable file paths in terminal output (absolute and relative paths with known extensions). Opens in IDE or markdown viewer.

Tab Features

  • Middle-click closes tab
  • Right-click context menu: Close, Close Other, Close Right, Rename, Detach to Window, Move to Worktree, Pin/Unpin, Copy Path
  • Drag-and-drop to reorder tabs
  • Double-click tab title to rename
  • Unseen activity badge when tab has new output

Split Panes

  • Max 4 panes per branch
  • Drag divider to resize
  • Flexible ratios preserved across layout changes
  • Modes: “separate” (independent tab bars) or “unified” (shared tab bar)

Configurable Settings

SettingDefaultDescription
copy_on_selecttrueAuto-copy terminal selection to clipboard
confirm_before_quittrueShow dialog when quitting with active terminals
confirm_before_closing_tabtrueShow dialog when closing tab with running process
split_tab_mode"separate"Tab bar mode for split panes
tab_ordering_mode"grouped-by-type"Tab ordering: “grouped-by-type”, “terminals-first”, “free”
intent_tab_titletrueShow agent intent as tab title
suggest_followupstrueShow suggested follow-up actions from agents
bell_style"visual"Terminal bell: “none”, “visual”, “sound”, “both”
prevent_sleep_when_busyfalsePrevent system sleep while terminal is busy