it2 session lookup descendants

Look up all descendant sessions

Synopsis

it2 session lookup descendants [<session-id>] [flags]

Description

Look up all descendant sessions recursively (children, grandchildren, etc.).

This command walks down the split tree from the given session and returns
all sessions that are descendants - children, grandchildren, and so on.

If no session ID is provided, uses the current session from ITERM_SESSION_ID.
If the session has no descendants, returns empty output.

Options

--json: Output result as JSON
-q, --quiet: Only output descendant session IDs (for scripting)

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

it2 session lookup - Look up session relationships and hierarchy

Examples

  # Basic Usage

  it2 session lookup descendants
  it2 session lookup descendants sess_abc123

  # Scripting Example - Close entire subtree

  for desc in $(it2 session lookup descendants -q); do
    it2 session close "$desc"
  done
  it2 session close sess_abc123  # Close root last