# iTerm2 changelog

> A terminal emulator for macOS with split panes, search, tmux integration and shell integration.

- Vendor: George Nachman
- Category: Developer Tools
- Platforms: macOS
- Official site: https://iterm2.com
- Tracked by: What's New (https://whatsnew.fyi/product/iterm2)
- Harvested from: Update feed
- Entries below: 2 (newest first)

What's New is an index, not a publisher: every entry below links to the vendor's own release notes, which are the authoritative source. Entries are labelled where they are hand-curated sample data, pre-releases, or drawn from a secondary source such as a developer blog.

## Releases

### 3.7.0beta8 — Version 3.7.0beta8

- Date: 2026-07-27
- Version: 3.7.0beta8
- Original notes: https://iterm2.com/appcasts/testing_changes3.txt
- Permalink: https://whatsnew.fyi/product/iterm2/releases/3.7.0beta8
- Labels: Pre-release; Platforms: macOS

- **added** — The it2 command-line tool now works on hosts you reach through SSH integration
- **changed** — Session-bound AI chats can now include your terminal's visible screen and state with each message automatically, and read the screen on request with the same get_screen_contents tool the orchestrator uses
- **changed** — The "View History" permission is now "View Contents" and gates both screen sharing and reading
- **changed** — AI chat can now restart a session for you, with the "Type for You" permission renamed to "Control Terminal" and now also gating session restart
- **changed** — An AI chat linked to a terminal session now stays linked when the session's shell restarts
- **changed** — AI chat orchestration is now much less chatty, reporting one line per real outcome instead of narrating every step
- **changed** — Companion push notifications are now coalesced so you get fewer notifications
- **changed** — Tab dragging is smoother with Metal staying enabled for normal drags, reorder slots switching near tab midpoints, and split-pane drop targets being more stable
- **changed** — The keychain permission prompt for AI API keys and paired companion device no longer recurs on every update, with secrets now living in an entitlement-scoped keychain group
- **changed** — Performance improvements
- **changed** — The retrospective debug log no longer retains typed characters, command lines, passwords, tokens, or AI chat content
- **changed** — The screenshot window's Copy to Clipboard button now flashes a "Copied!" confirmation
- **changed** — The settings search field again uses the system focus ring on macOS 26.5.1 and later
- **fixed** — An AI chat linked only to a web browser now uses a browser-appropriate system prompt instead of one that described a terminal
- **fixed** — Fixed a memory corruption bug that could crash iTerm2 intermittently when closing a tmux window caused surviving sessions to resize while output was still streaming
- **fixed** — Fixed a hang where a modal sheet whose parent window was destroyed before it was dismissed left the main thread frozen in the modal run loop
- **fixed** — Fixed key reporting using stale flags after switching between the main and alternate screen buffers, which could leave modified-key input wrong for some full-screen apps
- **fixed** — OSC 22 pointer shapes are now honored while mouse reporting is on, with fleur, watch, plus, and minus shapes added and X_cursor mapped to the not-allowed cursor
- **fixed** — Fixed flag emoji rendering as blank cells or flickering under the GPU renderer by shaping the two regional indicators together
- **fixed** — Command-clicking links in terminal output no longer crashes when command-mark data is unavailable

Note: if you are beta testing the iPhone companion
app iTerm2 Buddy, you'll need to update it after
upgrading iTerm2 to this version.

New Features:
- The it2 command-line tool now works on hosts
  you reach through SSH integration.

Improvements:
- Session-bound AI chats can now include your
  terminal’s visible screen and state with each
  message automatically, and read the screen on
  request with the same get_screen_contents tool
  the orchestrator uses (in a full-screen app it
  returns just the current screen, with no
  scrollback). The “View History” permission is
  now “View Contents” and gates both. iTerm2 asks
  once before it starts sharing your screen
  automatically, so a permission left at “Always”
  from an earlier version shares nothing until
  you confirm.
- AI chat can now restart a session for you. The
  “Type for You” permission was renamed “Control
  Terminal” and now also gates this.
- An AI chat linked to a terminal session now
  stays linked when the session’s shell restarts
  (which happens often with the Claude Code
  integration). Previously the link, its command
  permissions, and orchestrator @-mentions of the
  session were lost on every restart.
- AI chat orchestration is now much less chatty.
  While it runs a loop (for example, waiting for
  a Code Review to finish and then telling a
  session to continue), it reports one line per
  real outcome instead of narrating every step
  and asking what to do next each time.
- Companion push notifications are now coalesced
  so you get fewer notifications.
- The keychain permission prompt that appeared
  after upgrading, for AI API keys and for a
  paired companion device, no longer recurs on
  every update. Those secrets now live in an
  entitlement-scoped keychain group that stays
  readable across signed builds. Upgrading to
  this version prompts once more to move them.
- Tab dragging is smoother: Metal stays enabled
  for normal drags, reorder slots switch near tab
  midpoints, and split-pane drop targets are more
  stable.
- Performance improvements.
- The retrospective debug log no longer
  retains typed characters, command lines,
  passwords, tokens, or AI chat content. These
  could previously accumulate in memory even with
  debug logging off.
- The screenshot window’s Copy to Clipboard
  button now flashes a “Copied!” confirmation so
  you get feedback that the image was copied.
- The settings search field again uses the system
  focus ring on macOS 26.5.1 and later, where a
  workaround for an earlier OS bug otherwise left
  stray fragments below the capsule.

Bug Fixes:
- An AI chat linked only to a web browser now
  uses a browser-appropriate system prompt
  instead of one that described a terminal it was
  not attached to.
- Fixed a memory corruption bug that could crash
  iTerm2 intermittently, most often when closing
  a tmux window caused surviving sessions to
  resize while output was still streaming. Lazily
  cached line-wrapping info could be written into
  scrollback storage shared with another thread.
  Issue 12941.
- Fixed a hang where a modal sheet (such as an
  alert) whose parent window was destroyed before
  it was dismissed left the main thread frozen in
  the modal run loop forever.
- Fixed key reporting using stale flags after
  switching between the main and alternate screen
  buffers, which could leave modified-key input
  wrong for some full-screen apps. Issue 704.
- OSC 22 pointer shapes are now honored while
  mouse reporting is on, instead of always
  forcing the I-beam-with-circle cursor. Added
  the fleur, watch, plus, and minus shapes and
  mapped X_cursor to the not-allowed cursor.
  Issue 700.
- Fixed flag emoji (such as a country flag)
  rendering as blank cells or flickering under
  the GPU renderer. The two regional indicators
  that make up a flag are now shaped together,
  matching the non-GPU renderer.
- Command-clicking links in terminal output no
  longer crashes when command-mark data is
  unavailable.

_[Truncated at 4000 characters — full notes: https://iterm2.com/appcasts/testing_changes3.txt]_

### 3.6.11 — Version 3.6.11

- Date: 2026-06-02
- Version: 3.6.11
- Original notes: https://iterm2.com/appcasts/full_changes.txt
- Permalink: https://whatsnew.fyi/product/iterm2/releases/3.6.11
- Labels: Platforms: macOS

- Fix a number of bugs that caused crashes.
- Update AI models.