Source Intelligence
Follow Discord

DisclaimerUnofficial, and not affiliated with Anthropic. Nearly all of this is read straight out of what ships: npm bundles, captured prompts, published docs. Anthropic's own notes go in verbatim, marked as theirs. The rest is my reading, and every entry carries the strings behind it. If one looks wrong, vote it down and say why.

← All of v2.1.186 Home All releases ←olderv2.1.185 v2.1.187newer→
Claude Code v2.1.186

iTerm2 Teammate Pane Mode

The teammateMode setting now accepts "iterm2" as a value, allowing spawned agent teammates to open in iTerm2 split panes using the iTerm2 Python API.

Usage
# 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\"")

Strings lifted out of the shipped bundle, so the claim above can be checked against them.

See this entry in the whole of v2.1.186 →