All pages

Lesson 1.3 · Get set up · 12 min

Tabs, splits and the Quick Terminal

The terminal underneath: tabs, split panes, presets and the global overlay.

Listen

This lesson covers the terminal underneath TRMNLY: tabs, split panes, grid layouts, typing into several panes at once, and the Quick Terminal you can summon from any app.

Time: 12 minutes · Works on: macOS app

Tabs and windows

  1. Press ⌘T to open a new tab. Press ⌘N for a new window.
  2. Press ⇧⌘] and ⇧⌘[ to move to the next and previous tab. ⌘1 through ⌘8 jump to a tab by position, and ⌘9 jumps to the last tab.
  3. Press ⌘W to close the focused pane. When a tab has only one pane, that closes the tab.

Every tab gets its own agent conversation in the right sidebar, so two tabs can hold two separate threads.

Split panes

A tab is a tree of panes. Split it to run a server beside a shell, or a log beside an editor.

  1. Press ⌘D to split right.
  2. Press ⇧⌘D to split down.
  3. Move between panes with ⌘[ and ⌘], or with ⌘⌥ and an arrow key.
  4. Resize the focused pane with ⌘⌃ and an arrow key, or drag the divider.
  5. Press ⌘⌃= to make the panes equal again.
  6. Press ⇧⌘↩ to zoom the focused pane so it fills the tab. Press it again to bring the others back.

If you'd rather not remember the chords, use the + button above the terminal. It offers Split Right, Split Down, and Split Other Way with Split Left and Split Up, then New Tab, New Window and Choose Layout…. Once the tab has more than one pane it adds Zoom Pane and Equalize Panes.

Grid layouts

For common shapes, build the whole grid in one step.

  1. Choose View → Layouts… or press ⇧⌘L.
  2. Click a layout: Two Columns, Two Rows, Three Columns, Grid 2×2, Grid 3×2 or Main + Stack. Your current shell becomes the first pane and the rest open around it.
  3. When a tab is shaped the way you like, choose View → Save Split Layout… and give it a name.
  4. Later, in another tab, choose View → Apply Split Layout… to rebuild that shape.

A saved layout stores only the shape. It doesn't store commands, so applying one never runs anything.

Type into every pane

Sometimes you want the same command in several panes, such as git pull across four checkouts.

  1. Split a tab into two or more panes.
  2. Choose View → Broadcast Input to All Panes or press ⇧⌘I. The menu item shows a checkmark while it's on.
  3. Type a command. It appears in every pane of the tab.
  4. Press ⇧⌘I again to stop.

Broadcast pauses while a password prompt is up, so a typed password is never copied into the other panes.

A few more View menu tricks

  • Pane Fullscreen zooms the focused pane and hides both sidebars.
  • New tmux Pane opens a split running a fresh tmux session, so its processes outlive the window.
  • Lock Split Layout stops the panes re-equalizing when the window resizes.
  • Compare Pane With… diffs the focused pane's output against another pane in the window.

The Quick Terminal

The Quick Terminal is a floating terminal you can bring up over any app. It ships without a shortcut, so give it one first.

  1. Open Settings → Keybindings with ⌘,.
  2. Find Quick Terminal and record a key combination.
  3. Press your combination. The Quick Terminal slides down from the top of the screen.
  4. Run a command, then press the combination again to hide it. The shell keeps running while it's hidden.

You can also open it from View → Quick Terminal.

To make the shortcut work while another app is in front, bind it as a global key in your Ghostty config file instead:

keybind = global:ctrl+cmd+t=toggle_quick_terminal

The Quick Terminal docks to the top by default. Set quick-terminal-position in your config to bottom, left, right or center to move it.

Check yourself

  • You can split a tab four ways and get back to one pane with ⌘W.
  • You saved a split layout and applied it in a new tab.
  • Your Quick Terminal shortcut opens and hides it.

Go further