it2 session lookup lineage

Look up complete lineage (ancestors and descendants)

Synopsis

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

Description

Look up the complete lineage of a session including all ancestors and descendants.

This command shows the full family tree: all ancestors (walking up to root)
and all descendants (walking down recursively). This gives you a complete
picture of the session's position in the split hierarchy.

If no session ID is provided, uses the current session from ITERM_SESSION_ID.

Options

--json

Output result as JSON
-q, --quiet
Only output lineage 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

Examples

  # Basic Usage

  it2 session lookup lineage
  it2 session lookup lineage sess_abc123

  # JSON output with full tree structure

  it2 session lookup lineage --json

  # Scripting Example - Get all related sessions

  it2 session lookup lineage -q | while read sid; do
    it2 session send-text "$sid" "echo broadcasting"
  done