it2 session lookup split-root

Look up the root session of a split tree

Synopsis

it2 session lookup split-root [<session-id>] [flags]

Description

Look up the root session of a split tree by walking up the parent chain.

When sessions are created via splitting, they form a tree hierarchy with parent-child
relationships. This command finds the topmost session (root) of the split tree that
contains the given session.

This is different from 'session parent' which returns the immediate parent. The split-root
command walks up the entire parent chain to find the root session.

If no session ID is provided, uses the current session from ITERM_SESSION_ID.
If the session is already a root (has no parent), returns the session itself.

Examples

Basic Usage

$ it2 session split-root
$ it2 session split-root sess_abc123

# Scripting Example - Find all sessions in the same split tree

$ ROOT=$(it2 session split-root -q)
$ it2 session list --format json | jq -r ".[] | select(.parent == \"$ROOT\" or .id == \"$ROOT\") | .id"

Options

--json

Output result as JSON
-q, --quiet
Only output the root session ID (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