iTerm2

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.
• Hiding a hotkey window on macOS 26 no longer briefly flashes background iTerm2 windows to the front. The window now waits for the previously active app to come forward before ordering out.
• Global search no longer shows blank snippets for results found on the main screen while an alternate-screen app (such as a full-screen TUI) is running. Snippets are extracted from the same snapshot the search ran against.
• Fixed a case where a Claude Code workgroup pane (such as Diff or Code Review) could close itself when its command exited and take the whole workgroup down with it. Spawned workgroup panes now pin their end action so the profile’s “Close Sessions On End” setting can no longer flip them to close on their own.
• Reloading a diff session in a workgroup now re-runs the command matching the file picker’s current selection. Previously, if the file you were viewing stopped having changes and the picker snapped back to “All Files”, reload reran the old per-file diff, found nothing, and exited, closing the session.
• Fixed a black bar and off-by-a-row click hit-testing when filtering, taking a screenshot, or zooming lines in a session that carries extra chrome such as the workgroup peer-mode toolbar. Instant replay also restores the window to its original size on exit.
• The built-in web browser now prompts for a user name and password when a site returns an HTTP authentication challenge (Basic, Digest, or NTLM) instead of failing to load.
• A saved status bar layout whose RPC-provided text component is missing its registration request is now dropped instead of showing up as a blank “ghost” cell.
• Fixed modified keys such as Ctrl-J and Shift-Enter not reaching some apps (for example Codex) running under tmux integration (tmux -CC). iTerm2 now hands these keys to tmux by name so tmux encodes them just as it does outside control mode.
• Fixed auto-sending code review results to the main session sometimes failing to submit because the Return arrived too soon after the paste. The Return now waits a moment (see the workgroupAutoSendSubmitDelay advanced setting).
• If you never paired a companion device, iTerm2 no longer touches the companion keychain items at launch, avoiding a spurious keychain permission prompt for people who alternate differently-signed builds (such as a released build and one built from source).
• Fixed various crashes.

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