All pages

Docs · Other surfaces

Splits

Availability: macOS · Linux · Windows. Split presets and the split_* tools are macOS-only; the floating pane is on all three.

TRMNLY uses Ghostty's split system: each tab is a tree of panes that you grow with split commands. Splits inside a tab share the tab's project and env.

Splitting

Action Default
Split right ⌘D
Split left — (assign in Settings)
Split down ⌘⇧D
Split up —
Move focus to previous split ⌘[
Move focus to next split ⌘]
Move focus by direction ⌘⌥ + arrow
Resize split ⌘⌃ + arrow
Equalize splits ⌘⌃=
Zoom focused split (fill the tab) ⌘⇧↩

Drag the divider between panes to resize. Double-clicking a divider equalizes the splits in the tab.

The + button

The + next to the paperclip at the top of the terminal holds the same actions as a menu, for when you'd rather not remember the chord: Split Right, Split Down, and Split Other Way ▸ Split Left / Split Up; then New Tab, New Window and Choose Layout… (in a tab — a Quick Terminal has no tabs); then Move to Cloud…, which hands the pane's repository and its Claude Code conversation to your cloud workspace (see Cloud workspace; it is disabled until the Mac is paired with trmnly.dev, and its label says so). Once the tab holds more than one pane it adds Zoom Pane, Equalize Panes and Type Into Every Pane — the label names what the next click does, so it reads Stop Typing Into Every Pane while broadcast input is on. It ends with Close Pane and Close Tab. Each item sends the same action the menu bar does, so a rebound key keeps working; the items don't show shortcuts because yours may differ from the defaults.

Between the + and the paperclip are two small buttons for what's typed at the prompt: copy (the two-pages icon) puts the half-written command on the clipboard, and clear (the delete-left icon) erases it — for the command you have to abandon to run something else first. They act on the pane the strip is about and do nothing when the cursor isn't at a shell prompt (inside vim, mid-command); they need shell integration, which is how the terminal knows where the prompt ends and your typing begins.

The floating pane

Some things you want visible, not tiled: a log tailing, a diff you keep glancing at, a scratch shell. Splitting for those re-flows everything else around them. The floating pane is a terminal that sits above the split layout instead of dividing it — one per window, 640×384, with a shadow so it reads as elevated rather than as a pane someone mis-sized.

It is created on first use and then kept: toggling it off hides it rather than destroying it, so whatever is running in there is still running when you bring it back. Building it with the window instead would give every window a PTY and a shell nobody asked for.

  • macOS — a custom shortcut action, Toggle Floating Pane. No chord is bound by default; assign one in Settings → Shortcuts. See Custom shortcuts.
  • Linux and Windows — the window action win.toggle-float-pane. No default binding or menu item yet.

Behaviour is deliberately identical across the three, and so are the dimensions — this is the same feature implemented twice against two toolkits, not two features that resemble each other.

Grid layouts

For the common cases you don't want to build by hand, TRMNLY ships one-shot grid layouts. Open the visual picker from View → Layouts… (⌘⇧L) or the command palette, then click a layout to rebuild it around the focused pane — the running shell becomes the first pane and the rest are spawned around it. Other panes already in the tab are left alone.

Built-in grids:

Layout Shape
Two Columns 2 side-by-side panes
Two Rows 2 stacked panes
Three Columns 3 side-by-side panes
Grid 2×2 4 panes
Grid 3×2 6 panes
Main + Stack one large pane left, two stacked right

Grids are one-shot — apply and forget; nothing is saved. The picker also lists your saved presets (below) and has a Save Current… button to capture the current tree as a named preset. The same built-ins appear under View → New Grid Layout as a submenu.

Broadcast input

View → Broadcast Input to All Panes (⌘⇧I) toggles broadcast mode: keystrokes you type fan out to every pane in the tab at once — type a command once and run it everywhere. The menu item shows a checkmark while it's on. Toggle it off to go back to typing in just the focused pane.

Broadcast pauses automatically while a password prompt is up (whenever macOS secure keyboard entry is active), so a typed password is never mirrored into the other panes. Broadcast also turns itself off if the tab drops back to a single pane.

Split presets

Common layouts are tedious to recreate by hand. Split presets save a tree shape (horizontal/vertical splits with ratios) under a name, scoped to the current project (tabs without a project save to a global list).

  • Save — View → Save Split Layout…, or the Save Current… button in the Layouts… picker. You'll be prompted for a name.
  • Apply — View → Apply Split Layout…, or click the preset's thumbnail under "Saved Layouts" in the picker. The focused pane's running shell becomes the first pane of the shape.

Both actions are also searchable from the command palette. A preset is just a SplitLayoutShape JSON value plus a name; no contents or commands are stored, so applying a preset doesn't run anything.

The agent has the same through list_split_presets, save_split_preset, apply_split_preset and delete_split_preset, plus split_pane, focus_split, zoom_split and equalize_splits for the panes themselves.

More pane tricks (View menu)

  • New tmux Pane — opens a split running a fresh tmux session, so its processes survive the window closing. Reattach later from the Conn sidebar's tmux list or with tmux attach.
  • Lock Split Layout — stops the layout re-equalizing itself when the window resizes.
  • Pane Fullscreen — zooms the focused pane and collapses both sidebars so it really fills the window; toggle again to restore.
  • Compare Pane With… — diffs the focused pane's scrollback against another pane in the same window.

Per-pane vs per-tab

  • Project / env / theme → per-tab.
  • Working directory → per-pane (each pane starts in the tab's dir but you can cd independently).
  • Tab monitor rules → match against every pane's output in the tab.

Sample presets

Name Shape
editor+repl One pane right, ratio 0.6 / 0.4
dev+server+logs Top half single, bottom half split L/R
triple Three vertical panes, equal width

Save your own from a tab you've already shaped; presets stay with the project they were saved under.