it2 window tree

Show split tree structure for a window

Synopsis

it2 window tree [<window-id>] [flags]

Description

Display the split pane tree structure for all tabs in a window.

Shows the hierarchical structure of tabs, split containers, and sessions within a window.
The tree can be displayed visually or as raw JSON for programmatic access.

If no window ID is provided, uses the current window.

Options

--format (default "tree")

Output format (tree|json)

Options inherited from parent commands

--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

  • it2 window - Manage iTerm2 windows or navigate to window context

Examples

  # Show tree for current window
  it2 window tree

  # Show tree for specific window
  it2 window tree pty-ABC123

  # Get raw JSON structure
  it2 window tree --format json

  # Use with jq to list all tabs
  it2 window tree --format json | jq '.tabs[].tab_id'