{"version":"2.1.186","anchor":"iterm2-teammate-pane-mode","canonical_anchor":"iterm2-teammate-pane-mode","heading":"iTerm2 Teammate Pane Mode","tier":null,"area":null,"scope":null,"heads_up":null,"url":"https:\/\/changelogs.core-directive.com\/v\/2.1.186\/e\/iterm2-teammate-pane-mode","release_url":"https:\/\/changelogs.core-directive.com\/v\/2.1.186","markdown":"### iTerm2 Teammate Pane Mode\n\nThe `teammateMode` setting now accepts `\"iterm2\"` as a value, allowing spawned agent teammates to open in iTerm2 split panes using the iTerm2 Python API.\n\n**Usage**\n\n`# In your Claude Code settings.json { \"teammateMode\": \"iterm2\" }` **Details** - Requires the iTerm2 Python API to be enabled: Preferences > General > Magic > Enable Python API. - Requires the `it2` CLI tool: `pip install it2`. - If `it2` is not on PATH or the Python API is not enabled, Claude prints a diagnostic message and falls back to the next available mode. - If Claude is not running inside iTerm2, it warns and suggests changing `teammateMode`. - `\"auto\"` mode now also considers iTerm2 availability. - The `--scope server` CLI flag is now used for finer-grained `mcp remove` scope targeting. **Evidence** New \"iterm2\" option added to `teammateMode` enum (search for `\"How spawned teammates execute (tmux, iterm2, in-process, auto)\"` and `\"teammateMode is set to \\\"iterm2\\\"\"`)"}