Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Keyboard Shortcuts

All shortcuts use Cmd on macOS and Ctrl on Windows/Linux unless noted.

Customizing Keybindings

From the UI

Open Help > Keyboard Shortcuts (or Cmd+? → Keyboard Shortcuts). Click the pencil icon next to any shortcut to enter recording mode, then press your new key combination. The app warns you if the combo is already used by another action. Overridden shortcuts are highlighted in accent color with a reset icon to revert individually. A “Reset all to defaults” button is at the bottom.

By editing the config file

You can also edit the keybindings.json file directly in your config directory:

  • macOS: ~/Library/Application Support/tuicommander/keybindings.json
  • Windows: %APPDATA%\tuicommander\keybindings.json
  • Linux: ~/.config/tuicommander/keybindings.json

The file is a JSON array of override objects. Only include shortcuts you want to change — anything not listed uses the default:

[
  { "action": "toggle-git-ops", "key": "Cmd+Shift+Y" },
  { "action": "toggle-markdown", "key": "Cmd+Shift+M" }
]
  • "key" uses Cmd as the platform-agnostic modifier (resolved to Meta on macOS, Ctrl on Win/Linux)
  • Set "key": "" or "key": null to unbind an action
  • Changes made via the UI are saved to this same file
  • The file is loaded at startup — restart TUICommander to pick up manual edits

See the action table below for all available action names.

Global Hotkey

A configurable OS-level shortcut to toggle TUICommander’s visibility from any application.

  • Configure: Settings > Keyboard Shortcuts > Global Hotkey (top of the tab)
  • No default — you must set it yourself (e.g., Ctrl+Space, `Cmd+``)
  • Toggle behavior: hidden/minimized → show+focus, visible but unfocused → focus, focused → instant hide
  • Cmd and Ctrl are treated as distinct modifiers
  • Uses tauri-plugin-global-shortcut (no Accessibility permission required on macOS)
  • Not available in browser/PWA mode
  • Persists across app restarts

Terminal Operations

ShortcutAction
Cmd+TNew terminal tab
Cmd+WClose tab (or close active pane in split mode)
Cmd+Shift+TReopen last closed tab
Cmd+RRun saved command
Cmd+Shift+REdit and run command
Cmd+LClear terminal
Cmd+FFind in terminal / diff tab
Cmd+GGit Panel — Branches tab (or Find next match when search is open)
EnterFind next match (when search is open)
Cmd+Shift+G / Shift+EnterFind previous match (when search is open)
EscapeClose search overlay
Cmd+CCopy selection
Cmd+VPaste to terminal
Cmd+HomeScroll to top
Cmd+EndScroll to bottom
Shift+PageUpScroll page up
Shift+PageDownScroll page down

Tab Navigation

ShortcutAction
Cmd+1 through Cmd+9Switch to tab by number
Ctrl+TabNext tab
Ctrl+Shift+TabPrevious tab

Zoom

ShortcutAction
Cmd+= (or Cmd++)Zoom in (active terminal)
Cmd+-Zoom out (active terminal)
Cmd+0Reset zoom to default (active terminal)
Cmd+Shift+= (or Cmd+Shift++)Zoom in all terminals
Cmd+Shift+-Zoom out all terminals
Cmd+Shift+0Reset zoom all terminals

Font size range: 8px to 32px, step 2px per action.

Split Panes

ShortcutAction
Cmd+\Split vertically (side by side)
Cmd+Alt+\Split horizontally (stacked)
Alt+← / Alt+→Navigate panes (vertical split)
Alt+↑ / Alt+↓Navigate panes (horizontal split)
Cmd+WClose active pane (collapses to single)
Cmd+Shift+EnterMaximize / restore active pane
Cmd+Alt+EnterFocus mode — hide sidebar, tab bar, and all side panels (keeps toolbar + status bar)

Panels

ShortcutAction
Cmd+[Toggle sidebar
Cmd+Shift+DToggle Git Panel
Cmd+Shift+MToggle markdown panel
Cmd+Alt+NToggle Ideas panel
Cmd+EToggle file browser
Cmd+OOpen file… (picker)
Cmd+NNew file… (picker for name + location)
Cmd+,Open settings
Cmd+?Toggle help panel
Cmd+Shift+KPrompt library
Cmd+KClear scrollback
Cmd+Shift+WWorktree Manager
Cmd+JTask queue
Cmd+Shift+PToggle plan panel
Cmd+Shift+EToggle error log
Cmd+Shift+MMCP servers popup (per-repo)

Note: File browser and Markdown panels are mutually exclusive — opening one closes the other.

ShortcutAction
Cmd+PCommand palette
Cmd+Shift+AActivity dashboard

Git

ShortcutAction
Cmd+Shift+DGit Panel (opens on last active tab)
Cmd+GGit Panel — Branches tab
Cmd+BQuick branch switch (fuzzy search)

Branches Panel (when panel is focused)

ShortcutAction
/ Navigate branch list
Enter / double-clickCheckout selected branch
nCreate new branch (inline form)
dDelete branch (safe; hold to force)
RRename branch (inline edit)
MMerge selected branch into current
rRebase current onto selected branch
PPush branch (auto-sets upstream if missing)
pPull current branch
fFetch all remotes
Ctrl/Cmd+1–4Switch Git Panel tab (1=Changes, 2=Log, 3=Stashes, 4=Branches)

Quick Branch Switcher

ShortcutAction
Hold Cmd+Ctrl (macOS) or Ctrl+Alt (Win/Linux)Show quick switcher overlay
Cmd+Ctrl+1-9Switch to branch by index

While holding the modifier, all branches show numbered badges. Press a number to switch instantly.

File Browser (when panel is focused)

ShortcutAction
/ Navigate files
EnterOpen file or enter directory
BackspaceGo to parent directory
Cmd+CCopy selected file
Cmd+XCut selected file
Cmd+VPaste file into current directory

Code Editor (when editor tab is focused)

ShortcutAction
Cmd+SSave file

Ideas Panel (when textarea is focused)

ShortcutAction
EnterSubmit idea
Shift+EnterInsert newline

Voice Dictation

ShortcutAction
Hold F5Push-to-talk (configurable in Settings)

Hold to record, release to transcribe and inject text into active terminal.

Tab Context Menu (Right-click on tab)

ActionShortcut
Close TabCmd+W
Close Other Tabs
Close Tabs to the Right
Copy Path— (diff/editor/markdown file tabs)
Rename Tab(double-click tab name)
Detach to Window

Mouse Actions

ActionWhereEffect
ClickSidebar branchSwitch to branch
Double-clickSidebar branch nameRename branch
Double-clickTab nameRename tab
Right-clickTabContext menu
Right-clickSidebar branchBranch context menu
Middle-clickTabClose tab
DragTabReorder tabs
DragSidebar right edgeResize sidebar (200-500px)
ClickPR badge / CI ringOpen PR detail popover
ClickStatus bar CWD pathCopy path to clipboard
ClickStatus bar panel buttonsToggle Git/MD/FB/Ideas panels
DragPanel left edgeResize right-side panel (200-800px)
DragSplit pane dividerResize split terminal panes

Action Names Reference (for keybindings.json)

Action NameDefault ShortcutDescription
zoom-inCmd+=Zoom in
zoom-outCmd+-Zoom out
zoom-resetCmd+0Reset zoom
zoom-in-allCmd+Shift+=Zoom in all terminals
zoom-out-allCmd+Shift+-Zoom out all terminals
zoom-reset-allCmd+Shift+0Reset zoom all terminals
new-terminalCmd+TNew terminal tab
close-terminalCmd+WClose terminal/pane
reopen-closed-tabCmd+Shift+TReopen closed tab
clear-terminalCmd+LClear terminal
run-commandCmd+RRun saved command
edit-commandCmd+Shift+REdit and run command
split-verticalCmd+\Split vertically
split-horizontalCmd+Alt+\Split horizontally
prev-tabCtrl+Shift+TabPrevious tab
next-tabCtrl+TabNext tab
switch-tab-1..9Cmd+1..9Switch to tab N
toggle-sidebarCmd+[Toggle sidebar
toggle-markdownCmd+Shift+MToggle markdown panel
toggle-notesCmd+Alt+NToggle ideas panel
open-fileCmd+OOpen file picker
new-fileCmd+NCreate new file
toggle-file-browserCmd+EToggle file browser
prompt-libraryCmd+Shift+KPrompt library
toggle-settingsCmd+,Open settings
toggle-task-queueCmd+JTask queue
toggle-helpCmd+?Toggle help panel
toggle-git-opsCmd+Shift+DGit Panel
toggle-git-branchesCmd+GGit Panel — Branches tab
worktree-managerCmd+Shift+WWorktree Manager panel
quick-branch-switchCmd+BQuick branch switch
find-in-terminalCmd+FFind in terminal
command-paletteCmd+PCommand palette
activity-dashboardCmd+Shift+AActivity dashboard
toggle-error-logCmd+Shift+EToggle error log
toggle-mcp-popupCmd+Shift+MMCP servers popup (per-repo)
toggle-planCmd+Shift+PToggle plan panel
switch-branch-1..9Cmd+Ctrl+1..9Switch to branch N
scroll-to-topCmd+HomeScroll to top
scroll-to-bottomCmd+EndScroll to bottom
scroll-page-upShift+PageUpScroll page up
scroll-page-downShift+PageDownScroll page down
zoom-paneCmd+Shift+EnterMaximize/restore pane
toggle-focus-modeCmd+Alt+EnterFocus mode — hide sidebar/tab bar/panels
toggle-file-browser-content-searchCmd+Shift+FFile content search
toggle-diff-scrollCmd+Shift+GDiff scroll view
toggle-global-workspaceCmd+Shift+XToggle global workspace