it2 session resize

Resize a pane in a split layout

Synopsis

it2 session resize <session-id> [flags]

Description

Resize a pane's proportion in a split layout without changing the window size.

When resizing panes in a split layout:

  • For horizontal splits (stacked vertically): Use --rows or --height to set pane height
  • For vertical splits (side-by-side): Use --cols or --width to set pane width

The adjacent panes will be resized proportionally to maintain the total window size.

Examples:

Resize a pane to 5 lines tall (for horizontal splits)

$ it2 session resize abc123 --rows 5

Resize a pane to 40 columns wide (for vertical splits)

$ it2 session resize abc123 --cols 40

Using short flags

$ it2 session resize abc123 -r 10

Options

-c, --cols (default 0)
Width in columns (alias for --width)

--height (default 0)

Height in rows (lines)
-r, --rows (default 0)
Height in rows (alias for --height)
-w, --width (default 0)
Width in columns (characters)

Options inherited from parent commands

--format (default "text")

Output format (text, json, yaml) - affects how command results are displayed

--timeout

Timeout for API operations - how long to wait for iTerm2 to respond

--url

WebSocket URL for iTerm2 API - typically ws://localhost:1912 for local iTerm2

See Also