toowl
Install

Documentation

Keybindings

Default shortcuts on macOS and Linux, plus how to rebind.

On macOS, app actions use Cmd instead of Ctrl+Shift, so terminal control codes (Ctrl+C, Ctrl+D, Ctrl+W, Ctrl+Z) fall through to the shell unbound. Toggle the card below between the two layouts.

Clipboard & selection

Copy selection Cmd+C Ctrl+Shift+C
Paste Cmd+V Ctrl+Shift+V
Select entire buffer Cmd+A Ctrl+Shift+A
Send SIGINT (not copy) Ctrl+C Ctrl+C

Tabs & windows

New tab (inherits cwd) Cmd+T Ctrl+Shift+T
New window Cmd+N Ctrl+Shift+N
Next / previous tab Cmd+]Cmd+[ · Ctrl+TabCtrl+Shift+Tab Ctrl+TabCtrl+Shift+Tab
Close pane (or tab if last) Cmd+W Ctrl+Shift+W
Group the current tab Cmd+Opt+G Ctrl+Alt+G
Ungroup the current tab Cmd+Opt+Shift+G Ctrl+Alt+Shift+G
Collapse / expand the group Cmd+Opt+Shift+C Ctrl+Alt+Shift+C
Close tab unbound — bind close_tab unbound — bind close_tab

Panes

Split vertically Cmd+D Ctrl+Shift+D
Split horizontally Cmd+Shift+D Ctrl+Shift+E
Focus pane left/down/up/right Cmd+Opt+H/J/K/L Ctrl+Alt+H/J/K/L

Navigation

Scroll back / forward Shift+PageUpPageDown Shift+PageUpPageDown
Jump to top / bottom Shift+HomeEnd Shift+HomeEnd
Previous / next prompt Cmd+Shift+UpDown Ctrl+Shift+UpDown
Clear scrollback Cmd+K Ctrl+Shift+L

View & app

Command palette Cmd+Shift+P Ctrl+Shift+P
Toggle command timeline Cmd+Shift+M Ctrl+Shift+M
Toggle the Perch (sidebar) Cmd+B Ctrl+Shift+B
Settings Cmd+, Ctrl+,
Zoom in / out / reset Cmd+=Cmd+-Cmd+0 Ctrl+=Ctrl+-Ctrl+0
Fullscreen Cmd+Ctrl+F F11
Screenshot Cmd+Shift+S Ctrl+Shift+S
Start / stop recording Cmd+Opt+R Ctrl+Alt+R
Quit Cmd+Q Ctrl+Shift+Q
tmux-friendly by design. Plain Ctrl+B is left unbound so it stays free for tmux and the toowl TUI. The Perch toggles on Cmd+B on macOS and Ctrl+Shift+B on Linux — Cmd is a different modifier, so it never competes with Ctrl+B, and it matches the sidebar toggle in VS Code, Cursor and Zed. Ctrl+Shift+B also works on macOS. Ctrl+D (shell EOF) and Ctrl+W (readline kill-word) are deliberately left to the shell — splits and close use the Ctrl+Shift variants.

Rebind

  1. Open the command palette (Cmd+Shift+P / Ctrl+Shift+P).
  2. Find the action and click rebind.
  3. Press the new combo — it saves to config.toml and hot-reloads in ~150ms.

Or edit the [keybindings] table directly. Action names are the Action variants in snake_case — new_tab, close_tab, rename_tab, new_tab_group, toggle_sidebar — plus a few that take an argument (goto_tab:3, font_zoom:1, set_active_feather:2). The Configuration page covers the combo syntax.

Layout-aware arrows

With the tab strip on top, Shift+mod left / right walk tabs and up / down jump prompts. Flip the strip to the left and those pairs swap so the arrows follow the rail. Ctrl+Tab never changes. See Layouts.