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.

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

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