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.

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

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