it2 window
Manage iTerm2 windows or navigate to window context
Synopsis
it2 window [<window-id>] [command]
Description
Manage iTerm2 windows with support for both flat and hierarchical command styles.
Flat Command Examples:
it2 window list # List all windows
it2 window create # Create new window
it2 window close 1 # Close window 1
Hierarchical Command Examples:
it2 window 1 tab list # List tabs in window 1
it2 window 1 session list # List sessions in window 1
it2 window 1 tab 2 session list # List sessions in tab 2 of window 1
The hierarchical style provides context-aware navigation while maintaining
full compatibility with existing flat commands.
Commands
- it2 window clear-title - Clear the title of a window
- it2 window close - Close a window
- it2 window create - Create a new window
- it2 window current - Show the current window ID
- it2 window focus - Focus/activate a window
- it2 window get-property - Get a window property
- it2 window get-title - Get the title of a window
- it2 window list - List all iTerm2 windows
- it2 window set-property - Set a window property
- it2 window set-title - Set the title of a window
- it2 window tree - Show split tree structure for a 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 - iTerm2 API Command-Line Interface