toowl

Documentation

Keybindings

Default shortcuts on macOS, Linux, and Windows. Rebind from the palette or config.toml.

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 Ctrl+TabCtrl+Shift+Tab Ctrl+TabCtrl+Shift+Tab
Close pane (or tab if last) Cmd+W Ctrl+Shift+W

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) Ctrl+Shift+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 Ctrl+Shift+B on every platform. 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. Every keybindable action and its config string is on the Configuration page.