it2 session lookup children
Look up immediate children sessions
Synopsis
it2 session lookup children [<session-id>] [flags]
Description
Look up all immediate children of a session in the split tree.
When a session is split, the new sessions become children of the original session.
This command returns all sessions that have the given session as their direct parent.
If no session ID is provided, uses the current session from ITERM_SESSION_ID.
If the session has no children, returns empty output.
Examples
Basic Usage
$ it2 session lookup children
$ it2 session lookup children sess_abc123
# Scripting Example - Close all children
$ for child in $(it2 session lookup children -q); do
$ it2 session close "$child"
$ done
Options
-
--json - Output result as JSON
-
-q,--quiet - Only output child 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
- 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 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