All pages

Docs · Start here

Keybinds

Availability: macOS · Linux · Windows. The keybind system and the action ids are Ghostty's and are shared, but the default chords in this page are the macOS ones — the GTK app inherits Ghostty's ctrl+shift defaults instead. TRMNLY's own actions (prompts, runbooks, screenshots) are macOS-only.

TRMNLY inherits Ghostty's keybind system. Triggers are written as mod+mod+key strings (e.g. super+shift+k). The Settings → Keybindings tab records chords as you press them and writes the canonical form.

Modifier names: super (⌘), shift, alt (⌥), ctrl (⌃).

Default chords

Action Default Action id
New window ⌘N new_window
New tab ⌘T new_tab
Close surface ⌘W close_surface
Close tab ⌘⌥W close_tab
Close window ⌘⇧W close_window
Close all windows ⌘⌥⇧W close_all_windows
Previous tab ⌘⇧[ (also ⌃⇧Tab) previous_tab
Next tab ⌘⇧] (also ⌃Tab) next_tab
Split right ⌘D new_split:right
Split left — new_split:left
Split down ⌘⇧D new_split:down
Split up — new_split:up
Previous split ⌘[ goto_split:previous
Next split ⌘] goto_split:next
Focus split by direction ⌘⌥ + arrow goto_split:up etc.
Resize split ⌘⌃ + arrow resize_split:up,10 etc.
Equalize splits ⌘⌃= equalize_splits
Zoom split ⌘⇧↩ toggle_split_zoom
Copy ⌘C copy_to_clipboard
Paste ⌘V paste_from_clipboard
Paste from selection ⌘⇧V paste_from_selection
Select all ⌘A select_all
Find ⌘F start_search
Find next ⌘G navigate_search:next
Find previous ⌘⇧G navigate_search:previous
Command palette ⌘⇧P toggle_command_palette
Quick terminal — (bind it yourself) toggle_quick_terminal
Toggle fullscreen ⌘↩ (also ⌃⌘F) toggle_fullscreen
Increase font size ⌘+ increase_font_size:1
Decrease font size ⌘- decrease_font_size:1
Reset font size ⌘0 reset_font_size
Reload config ⌘⇧, reload_config
Quit ⌘Q quit

Window zoom vs font size

⌘+ / ⌘- change the focused pane's terminal font only. ⌥⌘+ / ⌥⌘- scale the whole terminal window — tab sidebar, agent panel, browser pane and every terminal pane — together, like browser zoom: 75, 85, 100, 110, 125, 150, 175 or 200%. The two compose (a pane at 16pt under 125% looks like 20pt), and text stays sharp at every level because it is re-rendered, not stretched.

Window zoom is one level for every window and is remembered across relaunches. The window keeps its size; the content inside it gets bigger, so fewer terminal columns fit. Settings, sheets and popovers are separate windows and aren't scaled. The window-zoom chords are menu items, so rebind them in System Settings → Keyboard → Keyboard Shortcuts → App Shortcuts (not in Settings → Keybindings, which edits Ghostty's own actions).

TRMNLY-specific surfaces

Action Default How
Zoom the whole window in ⌥⌘= (also ⌥⌘+) Menu: View → Zoom In
Zoom the whole window out ⌥⌘- Menu: View → Zoom Out
Window back to 100% ⌥⌘0 Menu: View → Actual Size (shows the current level)
Toggle left (tab) sidebar ⌘\ Menu: View → Show/Hide Tab Sidebar
Toggle right sidebar ⌘⇧\ Menu: View → Show/Hide Right Sidebar
Quick Switcher (tabs, projects, files, recent commands) ⌘K Menu: View → Quick Switcher
Grid layout picker ⌘⇧L Menu: View → Layouts… (see Splits)
Broadcast input to all panes ⌘⇧I Menu: View → Broadcast Input to All Panes
Dictate into terminal ⌘I Menu: View → Dictate into Terminal
Hands-free conversation ⌃⌘I Menu: View → Hands-Free Conversation
Auto-answer prompts in focused pane ⌘⇧A Menu: View → Auto-Answer Prompts in This Pane
Screenshot to agent chat ⌃⌘S (global) Seeded custom shortcut — Settings → Shortcuts
Screenshot to terminal input ⌃⇧⌘S (global) Seeded custom shortcut — Settings → Shortcuts
Prompt menu at the terminal cursor ⌘P Seeded custom shortcut — Settings → Shortcuts
Cycle agent posture chip ⇧Tab In the agent chat input (chip in the sidebar header)
Stop the agent and lock down (panic) ⌘⇧. In the agent sidebar (see Agent safety)
Show TRMNLY Help ⌘? Menu: Help → TRMNLY Help
Show First-Run Tour — Menu: Help → Show First-Run Tour
Share session — TRMNLY app menu → Share Session…
Export .cast transcript — TRMNLY app menu → Export Tab Transcript as .cast…

Recording a chord

In Settings → Keybindings:

  1. Find the action row (the search bar at the top of the Settings window jumps straight to it).
  2. Click Record, then press the chord. TRMNLY writes the canonical mod+key string.
  3. If the chord is already bound to something else, a conflict alert asks before overriding.
  4. Click Reset on a row to clear the override and fall back to the default.

An Advanced section at the bottom of the pane binds any raw action id, including ones not in the table.

This pane rebinds TRMNLY's built-in actions. To bind a chord to a new action — run a saved prompt, run a runbook, send text, or capture a screenshot — use Settings → Shortcuts instead. See Custom shortcuts.

Global (system-wide) keybinds

Triggers prefixed with global: in your Ghostty config fire even when TRMNLY isn't focused. The Quick Terminal is the canonical use — it ships unbound, so give toggle_quick_terminal a global chord.

keybind = global:ctrl+cmd+t=toggle_quick_terminal
keybind = global:ctrl+cmd+shift+space=toggle_command_palette

Anything bindable in-app can be made global by adding the prefix. How they are registered, and what can refuse them, differs by platform:

  • macOS — needs Accessibility permission. The first time one is registered TRMNLY prompts for it under System Settings → Privacy & Security → Accessibility; without it, only in-app bindings work.

  • Linux — goes through the XDG desktop portal, so your desktop decides. GNOME and KDE ask once and remember; a session with no portal running registers nothing.

  • Windows — registered with the OS directly. A chord another application already owns is refused for that binding alone and named in the log; the rest still register. Keys the OS reserves outright (ctrl+alt+delete) can never be taken. Unlike the other two, nothing prompts — a chord either works or is reported as taken.

    A global: binding with no modifier is refused there rather than honoured. Windows would grant it, and the result is that the key stops reaching every other application on the machine — a global:e takes the letter away from the whole desktop until you quit TRMNLY. macOS and Linux are not this sharp, because one goes through an event tap and the other asks the desktop first.

Setting bindings in your config

If you'd rather hand-edit, add to your Ghostty config:

keybind = super+shift+k=clear_screen
keybind = super+shift+p=toggle_command_palette

Overrides set in Settings layer on top of your config so the UI never silently mutates the file.