it2 session lookup
Look up session relationships and hierarchy
Description
Commands for looking up session relationships and hierarchy information.
These commands help you navigate the session tree structure by finding
parent-child relationships, split trees, and container lookups.
Commands
- it2 session lookup above - Look up the pane immediately above
- it2 session lookup after - Look up the pane immediately after (right or below)
- it2 session lookup ancestors - Look up all ancestor sessions
- it2 session lookup before - Look up the pane immediately before (left or above)
- it2 session lookup children - Look up immediate children sessions
- it2 session lookup descendants - Look up all descendant sessions
- it2 session lookup lineage - Look up complete lineage (ancestors and descendants)
- it2 session lookup parent - Look up the parent session ID
- it2 session lookup siblings - Look up sibling sessions
- it2 session lookup split-root - Look up the root session of a split tree
- it2 session lookup tab - Look up which tab contains a session
- it2 session lookup window - Look up which window contains a session
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 - Manage iTerm2 sessions
Examples
# Get the parent session
it2 session lookup parent
# Get the root of a split tree
it2 session lookup split-root sess_abc123
# Get which tab contains a session
it2 session lookup tab
# Get which window contains a session
it2 session lookup window