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:
- Find the action row (the search bar at the top of the Settings window jumps straight to it).
- Click Record, then press the chord. TRMNLY writes the canonical
mod+keystring. - If the chord is already bound to something else, a conflict alert asks before overriding.
- 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 — aglobal:etakes 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.