it2 session lookup before

Look up the pane immediately before (left or above)

Synopsis

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

Description

Look up the session in the pane immediately before the given session.

This performs spatial lookup that adapts to split direction:

  • In a horizontal split (left-to-right): finds the pane to the left
  • In a vertical split (top-to-bottom): finds the pane above

If no session ID is provided, uses the current session from ITERM_SESSION_ID.
If there is no pane before, returns empty output.

Examples

Basic Usage

$ it2 session lookup before
$ it2 session lookup before sess_abc123

# Scripting Example - Focus previous pane

$ prev=$(it2 session lookup before -q)
$ if [ -n "$prev" ]; then
$ it2 session focus "$prev"
$ fi

Options

--json

Output result as JSON
-q, --quiet
Only output the session ID (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