Skip to content

A modern terminal with a built-in multiplexer: close it and your sessions keep running. Run shells and tons of AI agents across your machines, then pick them up from desktop, browser, TUI and more. Written in Rust with no UI framework: interface drawn straight on the GPU. No Electron, GPUI or webview.

1.2 KB
Raw Blame

RotatePanes

{{since('20220624-141144-bd1b7c5d')}}

Rotates the sequence of panes within the active tab, preserving the sizes based on the tab positions.

Panes within a tab have an ordering that follows the creation order of the splits.

As an example, if you have three panes created in sequence using horizontal splits, their indices from left to right are 0, 1, 2:

|--------|----|----|
|   0    |  1 |  2 |
|--------|----|----|

If you perform a clockwise rotation on that tab, the indices are rearranged so that the panes are now 2, 0, 1.

|--------|----|----|
|   2    |  0 |  1 |
|--------|----|----|

If you instead perform a counter-clockwise rotation then the indices are rearranged so that the panes are now 1, 2, 0

|--------|----|----|
|   1    |  2 |  0 |
|--------|----|----|

The sizes of original positions are preserved; as you can see from the examples above, the left-most pane is still the largest of the panes despite rotating the panes withing those placements.

local act = wezterm.action

config.keys = {
  {
    key = 'b',
    mods = 'CTRL',
    action = act.RotatePanes 'CounterClockwise',
  },
  { key = 'n', mods = 'CTRL', action = act.RotatePanes 'Clockwise' },
}

See also PaneSelect.