it2 tab set-layout

Set the layout of a tab

Synopsis

it2 tab set-layout <tab-id> <layout> [flags]

Description

Set the split layout of a tab using predefined layouts.

WARNING: This command has limited implementation due to the complexity of the
iTerm2 SetTabLayout API, which requires exact tree structure matching.

Currently supported operations are limited. For most layout operations, use:

  • 'it2 session split' to create new splits
  • 'it2 session close' to remove sessions
  • 'it2 tab splits' to view current layout

Supported layout types: single, split, grid (all currently return helpful error messages)

Examples

# View current tab layout
$ it2 tab splits <tab-id>
# Create splits manually (recommended approach)
$ it2 session split --vertical
$ it2 session split --horizontal
# Attempt to set layout (will show helpful error message)
$ it2 tab set-layout <tab-id> split

Options

--format (default "table")

Output format (table|json|yaml|text)

--horizontal

Split horizontally (default is vertical)

--timeout (default "5s")

Command timeout

--url (default "ws://localhost:1912")

iTerm2 WebSocket URL

See Also