it2 Documentation
it2 is a command-line interface for controlling iTerm2 sessions, tabs,
windows, text, profiles, and notifications.
Choose your task
| I want to… | Start here |
|---|---|
| Install it2 and verify the connection | Quick start |
| Learn the basic automation pattern | Build a disposable worker pane |
| Understand connections and session targeting | How it2 works |
| Diagnose a failure | Troubleshoot it2 |
| Set command defaults | Configure it2 |
| Find a command example | Command examples |
| Assemble a larger shell workflow | Automation cookbook |
| Build an executable plugin | Develop an it2 plugin |
| Automate Claude Code | Claude Code integration |
| Link Claude conversations to terminal panes | Claude session linking |
| Automate Gemini CLI | Gemini CLI integration |
| Automate OpenAI Codex | OpenAI Codex integration |
| Look up Claude automation helpers | Claude automation reference |
| Distinguish tools, plugins, and hooks | Extensibility taxonomy |
| Inspect the experimental manifest fields | Plugin manifest data model |
| Look up an exact command or flag | Generated command reference |
Command shape
Most operations use a resource followed by an action:
it2 <resource> <action> [flags]
For example, it2 session list lists sessions and it2 window create creates
a window. Use it2 help <resource> <action> or the generated command
reference for exact arguments and flags.