it2
iTerm2 API Command-Line Interface
Description
A powerful command-line tool for controlling iTerm2 programmatically through its WebSocket API.
it2 provides comprehensive control over iTerm2 sessions, tabs, windows, and content.
It supports both traditional flat command syntax and intuitive hierarchical navigation.
Commands
- it2 app - Control the iTerm2 application
- it2 arrangement - Manage iTerm2 window arrangements
- it2 artifact - Manage session artifacts and attachments
- it2 attention - Request attention with visual effects
- it2 auth - Manage iTerm2 API authentication
- it2 badge - Manage session badges
- it2 broadcast - Manage broadcast domains
- it2 color - Manage iTerm2 colors and appearance
- it2 completion - Generate completion scripts for various shells
- it2 config - Manage it2 configuration
- it2 get-buffer - Get buffer contents with scrollback (shortcut for session get-buffer)
- it2 get-screen - Get current screen contents (shortcut for session get-screen)
- it2 job - Monitor jobs in iTerm2 sessions
- it2 notification - Subscribe to iTerm2 notifications
- it2 notify - Post macOS notification
- it2 plugin - Manage and run it2 plugins
- it2 prime - Output multi-agent communication guidelines for Claude sessions
- it2 profile - Manage iTerm2 profiles
- it2 prompt - Manage prompts and command history in iTerm2 sessions
- it2 quickstart - Get started with it2 - comprehensive guide for core workflows
- it2 selection - Manage text selection
- it2 session - Manage iTerm2 sessions
- it2 setup - Bootstrap iTerm2 and it2 for first use
- it2 shell - Shell state detection and prompt tracking
- it2 split - Split a session pane (shortcut for session split)
- it2 statusbar - Manage iTerm2 status bar components
- it2 subscribe - Subscribe to iTerm2 notifications
- it2 tab - Manage iTerm2 tabs
- it2 text - Text and buffer operations in iTerm2
- it2 tmux - Manage tmux integration
- it2 variable - Manage iTerm2 variables
- it2 version - Print the it2 CLI version
- it2 window - Manage iTerm2 windows or navigate to window context
Options
-
--format(default "text") - Output format (text, json, yaml)
-
--timeout - Timeout for API operations
-
--url - WebSocket URL for iTerm2 API