it2 session list

List all iTerm2 sessions

Synopsis

it2 session list [flags]

Description

List iTerm2 sessions with optional filtering and output customization.

Examples

# List all sessions in table format
$ it2 session list
# List sessions in JSON format for scripting
$ it2 session list --format json
# List sessions in a specific window
$ it2 session list --window-id 1
# List sessions with custom columns
$ it2 session list --columns id,name,title
# Sort sessions by name
$ it2 session list --sort name
# Export session list for backup
$ it2 session list --format json > sessions-backup.json
# Output only session IDs (quiet mode)
$ it2 session list -q
# Use with xargs to send text to all sessions
$ it2 session list -q | xargs -n1 -I {} it2 session send-text {} "echo hello"
# Use partial IDs with quiet mode
$ it2 session list -q | cut -c1-8 | xargs -n1 -I {} it2 session send-text {} "test"
# Count total sessions
$ it2 session list -q | wc -l

Options

--columns

Comma-separated list of columns to display (e.g., 'session id,window id,name')
-q, --quiet
Output only session IDs

--reverse

Reverse sort order (descending)

--scope

Override IT2_SCOPE env var (none,window,tab,parents,siblings,peers,lineage)

--sort

Column to sort by (e.g., 'Session ID', 'Window ID', 'Name')

--tab-id

Filter sessions by tab ID

--window-id

Filter sessions by window ID

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