Run coding agents side by side
it2 is a command-line tool for orchestrating the iTerm2 sessions where coding
agents run. With it2, you can create panes for multiple agents, send them tasks,
inspect their output and state, and coordinate their work from shell scripts or
another agent.
Under the hood, it2 exposes iTerm2's local automation API as command-line
operations, so the same tools also work for ordinary terminal automation.
Start with a coding agent
Paste this into your coding agent:
Install and configure it2 on this Mac so you can run and manage coding agents
in iTerm2. Verify each step instead of assuming it worked. Use the repository's
it2 skill for command syntax. Stop and tell me if iTerm2 needs a permission
approval. When setup is complete, report the installed version and current
iTerm2 session ID. Do not claim success unless `it2 session current` exits 0.
The Quick start gives the agent exact installation and
verification steps. It also includes a by-hand path.
Choose what to do next
| I want to… | Start here |
|---|---|
| Set up it2 for my coding agent | Quick start |
| Give my agent reliable it2 instructions | Install the it2 agent skill |
| Run and manage multiple coding agents | Run your first multi-agent workflow |
| Understand connections and session targeting | How it2 works |
| Diagnose a failure | Troubleshoot it2 |