it2 window create

Create a new window

Synopsis

it2 window create [profile] [flags]

Options

--focus

Focus the new window after creation

--profile (default "Default")

Profile to use for the new window

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 window - Manage iTerm2 windows or navigate to window context

Examples

# Create new window with default profile
$ it2 window create

# Create window with specific profile
$ it2 window create "My Profile"

# Create window and capture ID for later use
$ WINDOW_ID=$(it2 window create --format json | jq -r .window_id)

# Create multiple windows
$ for i in {1..3}; do it2 window create; done

# Create window with custom profile
$ it2 window create --profile "Hotkey Window"