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)

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

it2 tab - Manage iTerm2 tabs

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