# iTerm2 changelog

> A macOS terminal with split panes and tmux 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: 13 (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.

Reuse: the summaries, labels and curation here are © What's New. Quote freely with attribution and a link back; wholesale republication of the corpus is not permitted — terms: https://whatsnew.fyi/terms. The vendors' own release notes remain their publishers'.

## Releases

### 3.7.4 — Version 3.7.4

- Date: 2026-10-08
- Version: 3.7.4
- Original notes: https://iterm2.com/appcasts/full_changes.txt
- Permalink: https://whatsnew.fyi/product/iterm2/releases/3.7.4
- Labels: Platforms: macOS

- **fixed** — Fixed a crash that could recur every time iTerm2 saved window state, caused by duplicate entries stored in the saved-state database when quitting during a save
- **fixed** — Fixed a crash when opening a new tab next to a tab in a tab group
- **fixed** — iTerm2 no longer crashes when its app was moved, deleted, or replaced while running; it now explains that the app is damaged and quits
- **fixed** — Fixed a crash when exiting full screen in a window without a title bar, such as a tmux integration window, on macOS 26
- **fixed** — Fixed a crash with the GPU renderer that could happen after changing the font size with Cmd-+ or Cmd--
- **fixed** — Fixed a crash that could happen when the GPU renderer had been running for several weeks without restarting iTerm2
- **fixed** — Fixed a crash when pressing Cmd-Z after closing a pane, toolbelt tool, or other view that had edited text
- **fixed** — Fixed a crash when a program printed a letter followed by many spacing marks in a later write
- **fixed** — Fixed a crash in "Import All Settings and Data" when the import changed a setting that requires an administrator password
- **fixed** — Fixed "Export All Settings and Data" failing with "Failed to copy file" after using SSH Integration by skipping temporary connection files that could not be copied
- **fixed** — Fixed crashes loading Dynamic Profiles files with values of an unexpected type; these values are now ignored or reported instead
- **fixed** — Fixed a crash, repeated on every relaunch, when a profile's name began with a combining mark
- **fixed** — Fixed various other crashes involving Find, the composer, splitting panes, Smart Selection, right-to-left text, VoiceOver, the GPU renderer, and quitting during startup
- **fixed** — Pressing space twice in a terminal no longer types a period when macOS's "Add period with double-space" setting is on
- **changed** — iTerm2 no longer applies macOS's automatic spelling correction, capitalization, or smart quotes and dashes to terminal input; text replacements still work
- **fixed** — Make Text Bigger works again when typed as ⌘⇧=, which previously opened the Clippings panel since 3.7.0
- **changed** — Show Clippings is now ⌘⇧⌥G
- **fixed** — Help popovers no longer cut off the last line of text and no longer scroll when all of their text fits

Bug Fixes:
- Fixed a crash that could recur every time
  iTerm2 saved window state. Quitting while a
  save was in progress could store duplicate
  entries in the saved-state database, which
  later saves could not handle.
- Fixed a crash when opening a new tab next to a
  tab in a tab group.
- iTerm2 no longer crashes when its app was
  moved, deleted, or replaced while running,
  for example by an installer. It now explains
  that the app is damaged and quits.
- Fixed a crash when exiting full screen in a
  window without a title bar, such as a tmux
  integration window, on macOS 26.
- Fixed a crash with the GPU renderer that
  could happen after changing the font size
  with Cmd-+ or Cmd--.
- Fixed a crash that could happen when the GPU
  renderer had been running for several weeks
  without restarting iTerm2. Issue 13103.
- Fixed a crash when pressing Cmd-Z after
  closing a pane, toolbelt tool, or other view
  that had text you had edited.
- Fixed a crash when a program printed a
  letter followed by many spacing marks (such
  as Devanagari vowel signs) in a later write.
  Issue 13073.
- Fixed a crash in “Import All Settings and
  Data” when the import changed a setting that
  requires your administrator password.
- Fixed “Export All Settings and Data” failing
  with “Failed to copy file” after using SSH
  Integration. Temporary connection files it
  could not copy are now skipped.
- Fixed crashes loading Dynamic Profiles files
  with values of an unexpected type, such as a
  null value or a Keyboard Map that is not an
  object. These values are now ignored or
  reported instead.
- Fixed a crash, repeated on every relaunch,
  when a profile’s name began with a combining
  mark.
- Fixed various other crashes, including ones
  involving Find, the composer, splitting
  panes, Smart Selection, right-to-left text,
  VoiceOver, the GPU renderer, and quitting
  while iTerm2 was still starting up.
- Pressing space twice in a terminal no longer
  types a period when macOS’s “Add period with
  double-space” setting is on. In vim this could
  repeat your last command. Issue 13123.
- iTerm2 no longer applies macOS’s automatic
  spelling correction, capitalization, or smart
  quotes and dashes. They could change what you
  type in a terminal. Text replacements still
  work.
- Make Text Bigger works again when you type it
  as ⌘⇧= (the way you type ⌘+). Since 3.7.0,
  that keystroke opened the Clippings panel
  instead, because Show Clippings had claimed it.
  Show Clippings is now ⌘⇧⌥G. Issue 13022.
- Help popovers, such as the ones shown by the ?
  buttons in Settings, no longer cut off the last
  line of text, and no longer scroll when all of
  their text fits.

### 3.7.4beta1 — Version 3.7.4beta1

- Date: 2026-09-30
- Version: 3.7.4beta1
- Original notes: https://iterm2.com/appcasts/testing_changes3.txt
- Permalink: https://whatsnew.fyi/product/iterm2/releases/3.7.4beta1
- Labels: Pre-release; Platforms: macOS

- **added** — iTerm2 interface is now localized in Brazilian Portuguese, German, Japanese, Russian, and Simplified Chinese
- **added** — Ollama is now a first-class AI provider with automatic model discovery, context window detection, and support for thinking, tools, and vision capabilities
- **added** — OSC 1337 SetColors escape sequence now accepts palette indices as values (i:N where N is 0-255) that track the loaded color preset
- **added** — New OSC 1337 codes SetWindowFrame, ReportWindowFrame, and ReportScreenFrames allow programs to move and resize windows across monitors using global coordinates
- **added** — iTerm2 now answers CSI 16 t to report character cell size
- **added** — Window > Lock Location pins a window to its display and position, returning it if moved or when the display reconnects
- **added** — New Centered, No Title Bar window style option
- **added** — Window name can now appear beside tabs in Compact and Minimal themes
- **changed** — ⌘Z now undoes text editing in the current field instead of closing tabs; ⌘⇧Z redoes; ⌘⇧T is now solely for Shell > Undo Close
- **added** — New Prevent sleep profile setting keeps the Mac from idle-sleeping while a session with the setting enabled exists
- **added** — New Set Profile Setting trigger action turns a profile checkbox on or off for the session
- **added** — New per-profile Use HDR cursor when available setting with brightness slider in Settings > Profiles > Colors
- **added** — Built-in web browser now remembers HTTP basic-auth user names and passwords via Keychain and other password managers
- **added** — Password manager settings menu now offers option to ask for Touch ID or password every time it opens, closing on screen lock
- **changed** — Dragging a tab into a collapsed tab group now adds it to that group, expanding the group only if the active tab was dragged
- **added** — ⌘F in AI chat now searches the current conversation with match counts and highlighting
- **added** — Right-clicking your own message in AI chat offers Delete to remove that message and everything after it
- **added** — AI chat can now set a timer to act after a delay or at a set time and survives restarts
- **added** — Right-to-left rendering, selection, and copy improvements
- **changed** — Ollama model context window is now sized to the prompt so long prompts are no longer silently truncated

September 30, 2026.

Credit to Nimanou (nuved) for the right-to-left
rendering, selection, and copy improvements in
this release.

Major New Features:
- iTerm2 is now localized: the interface follows
  your Mac’s language and is available in
  Brazilian Portuguese, German, Japanese, Russian,
  and Simplified Chinese.

New Features:
- Ollama is now a first-class AI provider
  alongside OpenAI, Anthropic, Gemini, and
  DeepSeek. Choosing it lists the models installed
  on your local Ollama server automatically,
  reading each model’s context window and
  capabilities (thinking, tools, vision) from the
  server, and newly pulled models show up on
  refresh. When Ollama is your default provider
  you pick which model to use for regular chats
  and an optional smaller one for quick background
  tasks. The chat’s Think toggle now controls
  whether a reasoning-capable local model thinks,
  and the context window is sized to your prompt
  so long prompts are no longer silently
  truncated. A non-local Ollama server can still
  be added as a manual model, where a Fetch Models
  button lists its models and a Vision checkbox
  lets image-capable models accept images.
- The OSC 1337 SetColors escape sequence now
  accepts a palette index as the value, written
  i:N where N is 0-255. Indices 0-15 track the
  loaded color preset, so a badge or tab color can
  follow the preset instead of a hardcoded RGB
  value. For example, SetColors=badge=i:3 uses
  ANSI yellow. Issue 12991.
- New OSC 1337 codes let a program move and resize
  its window across monitors using global
  coordinates: SetWindowFrame=x;y;w;h sets the
  frame, while ReportWindowFrame and
  ReportScreenFrames report the current frame and
  the layout of all displays. Unlike the older CSI
  3;x;y t sequence, these are not limited to the
  monitor the window is already on.
- iTerm2 now answers CSI 16 t (report character
  cell size), which was previously ignored.
- Window > Lock Location pins a window to the
  display and position it has when you turn it on.
  If anything moves the window it goes right back,
  and when that display is disconnected, as
  happens while a laptop sleeps, the window waits
  and returns when the display comes back.
  Dragging the window turns the lock off. Styles
  that fill or attach to the screen, such as
  Maximized, Centered, and the edge-attached
  styles, keep their usual shape and are held to
  their display instead. Note that macOS puts a
  returning window on whichever Space its display
  is showing at the time, which may not be the
  Space it left. Issue 13031.
- There is a new “Centered, No Title Bar” window
  style, in Settings > Profiles > Window > Style
  and in the Window > Window Style menu. It stays
  centered on the screen like the Centered style
  but has no title bar or window controls, which
  is how Centered windows looked before 3.7.0.
  Issue 13043.
- The window name can now appear beside the tabs
  in the Compact and Minimal themes, which have no
  title bar to show it in. By default it appears
  only once you name a window with Window > Edit
  Window Title, so windows you have not named look
  exactly as before. Double-click the name to
  rename the window.
- ⌘Z now undoes text editing in the field you’re
  editing (the composer, browser address bar,
  annotations, notes, and AI chat), and ⌘⇧Z
  redoes. Undo Close is now solely Shell > Undo
  Close (⌘⇧T). The first time you press ⌘Z with a
  recently closed session still restorable, a
  one-time notice explains the change and lets you
  choose Undo Close or a regular undo.
- A new “Prevent sleep” profile setting keeps the
  Mac from idle-sleeping while a session with the
  setting enabled exists. By default it applies on
  AC power only.
- A new “Set Profile Setting” trigger action turns
  a profile checkbox on or off for the session.
  Paired with Job Started and Job Ended matches,
  it gives “while this job runs” logic, such as
  preventing sleep only while a long-running jo

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

### 3.7.3 — Version 3.7.3

- Date: 2026-09-23
- Version: 3.7.3
- Original notes: https://iterm2.com/appcasts/full_changes.txt
- Permalink: https://whatsnew.fyi/product/iterm2/releases/3.7.3
- Labels: Platforms: macOS

- **fixed** — Python API now reports OSC 8 hyperlinks by populating a cell's CellStyle.url so scripts reading screen contents can see the link target
- **fixed** — Screen setting in Settings > Profiles > Window now shows a checkmark when set to Main Screen and displays correctly when reopened
- **fixed** — Crash when a program wrote a hyperlink whose web address contained an emoji or other character outside the Basic Multilingual Plane
- **fixed** — Severe typing lag in tmux Integration sessions running on a host connected to with an SSH profile
- **fixed** — Occasional delayed screen updates in a session that had gone quiet
- **fixed** — Profile with custom working directory using a tilde now correctly uses that directory instead of reporting it as unavailable
- **fixed** — Editing only the keystroke of a Select Menu Item or Toggle Setting key binding no longer erases the menu item or setting it was bound to
- **fixed** — Flag emoji now render as two columns instead of four, eliminating gaps after them
- **fixed** — Character combining with the one before it now renders at the correct width when the two halves arrive in separate writes
- **fixed** — Cmd-number tab shortcuts now remain consecutive after changing a tab group from the context menu
- **fixed** — Kitty graphics placeholder cells now render when the image id fits in three bytes and the program omits the optional diacritic
- **fixed** — Crash when asking for notification permission due to reply block being called after going out of scope
- **fixed** — Python runtime installation now trusts certificates installed on your Mac for networks that inspect secure traffic
- **fixed** — Unbounded memory growth with programs that animate using the Kitty graphics protocol
- **fixed** — Blank space rendering as a stray tilde with the GPU renderer in profiles with Anti-aliased turned off

Bug Fixes:
- Fixed the Python API not reporting OSC 8
  hyperlinks. A cell’s CellStyle.url is now
  populated, so scripts reading screen contents
  can see the link target.
- Fixed the Screen setting in Settings >
  Profiles > Window. Choosing “Main Screen”
  left the popup blank and showed no checkmark
  next to it when reopened, although the
  setting was saved correctly.
- Fixed a crash when a program wrote a hyperlink
  whose web address contained an emoji or other
  character outside the Basic Multilingual
  Plane. The link is now handled correctly
  instead of terminating iTerm2, which could
  recur on restore because the saved session
  replayed the same link.
- Fixed severe typing lag in a tmux Integration
  session running on a host you connected to
  with an SSH profile. Keystrokes and the output
  they produced were each held back about a
  second, so typing arrived in slow bursts.
- Fixed occasional delayed screen updates in a
  session that had gone quiet. A redraw with no
  other output behind it could be held back
  until something else happened in the session.
- Fixed a bug where a profile whose custom
  working directory used a tilde (such as
  ~/www) wrongly reported the directory as
  unavailable and started in the home
  directory instead.
- Fixed a bug where editing only the keystroke
  of a Select Menu Item or Toggle Setting key
  binding erased the menu item or setting it
  was bound to.
- Fixed a bug where a flag emoji took four
  columns instead of two, leaving a gap after
  it. A flag is now always two columns, the
  width other terminals report for it, so the
  advanced setting “Lone regional indicators
  render full-width” no longer affects flags.
  Skin-toned emoji are still affected and will
  be fixed separately.
- Fixed a bug where a character that combined
  with the one before it could come out the
  wrong width when the two halves arrived in
  separate writes, leaving the cursor inside
  the character.
- Fixed Cmd-number tab shortcuts becoming
  non-consecutive after changing a tab group
  from the context menu. Removing a tab from a
  group reordered the tabs but left the
  shortcut numbers on their old positions.
- Fixed Kitty graphics placeholder cells
  drawing nothing when the image id fit in
  three bytes and the program omitted the
  optional diacritic that carries the high
  byte. Other terminals render these, and now
  iTerm2 does too.
- Fixed a crash when asking for notification
  permission. The reply block could be called
  after it had gone out of scope, which could
  terminate iTerm2 at the moment a
  notification was first requested.
- Installing the Python runtime used by scripts
  now trusts the certificates installed on your
  Mac. On networks that inspect secure traffic,
  it could fail with a certificate error even
  though the same download succeeded in a
  browser.
- Fixed unbounded memory growth with programs
  that animate using the Kitty graphics
  protocol. Each redrawn frame was kept for the
  life of the window, so a long-running
  animation could consume many gigabytes.
- Fixed a bug where blank space rendered as a
  stray “~” with the GPU renderer in profiles
  that have Anti-aliased turned off. It showed
  up most often in bold runs and in the padding
  of full-screen programs like k9s, and it
  persisted for the rest of the session once it
  appeared.

### 3.7.2 — Version 3.7.2

- Date: 2026-09-15
- Version: 3.7.2
- Original notes: https://iterm2.com/appcasts/full_changes.txt
- Permalink: https://whatsnew.fyi/product/iterm2/releases/3.7.2
- Labels: Platforms: macOS

- **fixed** — Fixed a crash when editing a dynamic profile whose file had been changed on disk
- **fixed** — Fixed a crash when clicking the bookmark button on a command in the terminal
- **fixed** — Fixed a crash in the GPU renderer on macOS 26 caused by configuring the drawable timeout off the main thread
- **fixed** — Fixed a crash that could occur when quitting iTerm2 while several Claude Code sessions were running
- **fixed** — Fixed a crash when attaching over tmux -CC to a window whose panes are all floating
- **fixed** — Fixed the filter bar briefly matching every line when you changed the query while a search was still in progress
- **fixed** — Fixed tmux pane sizing when a per-session toolbar is shown
- **fixed** — Stopped falsely offering to reset the key reporting mode after every command when using Fish with oh-my-posh
- **fixed** — Fixed a performance regression from 3.7.0 that made typing lag or arrive in bursts when using terminal multiplexers and other programs that query the terminal's colors
- **fixed** — Fixed a bug on macOS 26 where the tab bar became short and shifted down after entering and exiting Lion fullscreen
- **fixed** — The Companion setup wizard now saves the pasted API key for the provider you chose in the popup
- **fixed** — Fixed the workgroup toolbar's auto-request-review and auto-send-clippings toggles showing a stale off state after a restart
- **changed** — Notify on Status Change no longer claims ⇧⌘X as a default keyboard shortcut to avoid shadowing macOS Services
- **fixed** — Fixed extended key reporting being lost after a restart with session restoration on
- **fixed** — Fix performance problems with window titles changing in tmux

Bug Fixes:
- Fixed a crash when editing a dynamic profile
  whose file had been changed on disk.
- Fixed a crash when clicking the bookmark
  button on a command in the terminal.
- Fixed a crash in the GPU renderer on macOS 26
  caused by configuring the drawable timeout off
  the main thread.
- Fixed a crash that could occur when quitting
  iTerm2 while several Claude Code sessions were
  running.
- Fixed a crash when attaching over tmux -CC to
  a window whose panes are all floating, which
  tmux 3.8 reports with an empty layout.
- Fixed the filter bar briefly matching every
  line when you changed the query while a search
  was still in progress, such as by typing
  quickly.
- Fixed tmux pane sizing when a per-session
  toolbar (such as the workgroups toolbar) is
  shown. Panes were told they had more rows than
  actually fit, so content rendered behind the
  toolbar and appeared to jump.
- Stopped falsely offering to reset the key
  reporting mode after every command when using
  Fish with oh-my-posh, which together emit a
  duplicate command-finished mark after
  re-enabling the keyboard protocol for the next
  prompt.
- Fixed a performance regression from 3.7.0 that
  made typing lag or arrive in bursts when using
  terminal multiplexers (such as tmux -CC) and
  other programs that query the terminal’s colors,
  especially when switching tabs or windows.
- Fixed a bug on macOS 26 where the tab bar
  became short and shifted down after entering
  and exiting Lion fullscreen, and where the
  tabs sat jammed against the top of the screen
  in fullscreen. Affects the Tahoe tab bar with
  tabs on top.
- The Companion setup wizard now saves the
  pasted API key for the provider you chose
  in the popup, so choosing a provider
  other than the current default no longer
  stores the key under the wrong service.
- Fixed the workgroup toolbar’s
  auto-request-review and auto-send-clippings
  toggles showing a stale off state after a
  restart even though they were actually on, so
  the button now always matches whether the
  behavior is enabled.
- Notify on Status Change no longer claims
  ⇧⌘X as a default keyboard shortcut. That
  shortcut could shadow a macOS Service bound
  to the same keys. Assign your own shortcut
  in System Settings > Keyboard > Keyboard
  Shortcuts > App Shortcuts if you want one.
- Fixed extended key reporting being lost after
  a restart with session restoration on. An app
  that had turned on modifyOtherKeys (so keys
  like Shift-Enter send a distinct code) now
  keeps working when its session is restored,
  instead of quietly reverting to plain keys.
- Fix performance problems with window titles
  changing in tmux.

### 3.7.1 — Version 3.7.1

- Date: 2026-09-10
- Version: 3.7.1
- Original notes: https://iterm2.com/appcasts/full_changes.txt
- Permalink: https://whatsnew.fyi/product/iterm2/releases/3.7.1
- Labels: Platforms: macOS

- **changed** — Newlines embedded in a completion suggestion now show as a return glyph so the entry stays on one line instead of spilling across rows
- **fixed** — Fixed a crash on launch when restoring saved sessions that contained right-to-left text written by version 3.6.11
- **fixed** — Fixed a memory leak where browser panes were never freed, leaking a WebKit process and a system power-management handle on every page load
- **fixed** — Fixed a bug where navigating between tmux sessions or windows could freeze the UI for several seconds
- **fixed** — Fixed dragging a file out of a session that failed when the terminal app used kitty's drag-and-drop protocol
- **fixed** — Fixed cmd-clicking a URL at the end of a line in a full-screen app, which could open the URL with text from the next line appended
- **fixed** — Fixed AI tool calls failing with Ollama when a tool used a non-string argument such as a number or boolean
- **fixed** — Fixed a bug where a Python script that created a window and immediately read its current tab or session got nothing back
- **fixed** — Fixed Duplicate Tab so a tab duplicated from a tab group stays in that group instead of being left as a stray one-tab group
- **fixed** — Fixed a bug where removing a tab from the middle of a tab group left the group discontiguous
- **fixed** — Fixed a spurious offer to reset key reporting mode after running a command in shells that use the kitty keyboard protocol
- **fixed** — Fixed the tab group outline in the Tahoe theme, which was being clipped
- **fixed** — Fixed a faint vertical line that could appear inside a selected tab in the dark Tahoe theme

Improvements:
- Newlines embedded in a completion suggestion
  (such as a command-history entry or file name)
  now show as a return glyph so the entry stays
  on one line instead of spilling across rows.
  The value inserted when you accept the row is
  unchanged.

Bug Fixes:
- Fixed a crash on launch when restoring saved
  sessions that contained right-to-left text
  written by version 3.6.11. This could force you
  to discard all of your restored sessions.
- Fixed a memory leak where browser panes were
  never freed, leaking a WebKit process and a
  system power-management handle on every page
  load. Over time this could exhaust a
  system-wide limit and break other apps that
  manage power (such as OrbStack).
- Fixed a bug where navigating between tmux
  sessions or windows could freeze the UI for
  several seconds.
- Fixed dragging a file out of a session that
  failed when the terminal app used kitty's
  drag-and-drop protocol.
- Fixed cmd-clicking a URL at the end of a line
  in a full-screen app (such as irssi or mutt),
  which could open the URL with text from the
  next line appended.
- Fixed AI tool calls failing with Ollama when a
  tool used a non-string argument such as a
  number or boolean.
- Fixed a bug where a Python script that created
  a window and immediately read its current tab
  or session got nothing back, which broke
  scripts that split panes or changed the font of
  a freshly created window.
- Fixed Duplicate Tab so a tab duplicated from a
  tab group stays in that group instead of being
  left as a stray one-tab group.
- Fixed a bug where removing a tab from the
  middle of a tab group left the group
  discontiguous.
- Fixed a spurious offer to reset key reporting
  mode after running a command in shells that use
  the kitty keyboard protocol, such as Fish 4.
- Fixed the tab group outline in the Tahoe theme,
  which was being clipped: the top and bottom
  lines, the outline around the group chip, and
  the rounded end caps of the first or last group
  in the tab bar were partly or fully missing.
- Fixed a faint vertical line that could appear
  inside a selected tab in the dark Tahoe theme.

### 3.7.1beta1 — Version 3.7.1beta1

- Date: 2026-09-10
- Version: 3.7.1beta1
- Original notes: https://iterm2.com/appcasts/testing_changes3.txt
- Permalink: https://whatsnew.fyi/product/iterm2/releases/3.7.1beta1
- Labels: Pre-release; Platforms: macOS

- **changed** — Newlines embedded in completion suggestions now show as a return glyph to keep entries on one line instead of spilling across rows
- **fixed** — Fixed a crash on launch when restoring saved sessions that contained right-to-left text written by version 3.6.11
- **fixed** — Fixed a memory leak where browser panes were never freed, leaking a WebKit process and a system power-management handle on every page load
- **fixed** — Fixed a bug where navigating between tmux sessions or windows could freeze the UI for several seconds
- **fixed** — Fixed dragging a file out of a session that failed when the terminal app used kitty's drag-and-drop protocol
- **fixed** — Fixed cmd-clicking a URL at the end of a line in a full-screen app that could open the URL with text from the next line appended
- **fixed** — Fixed AI tool calls failing with Ollama when a tool used a non-string argument such as a number or boolean
- **fixed** — Fixed a bug where a Python script that created a window and immediately read its current tab or session got nothing back
- **fixed** — Fixed Duplicate Tab so a tab duplicated from a tab group stays in that group instead of being left as a stray one-tab group
- **fixed** — Fixed a bug where removing a tab from the middle of a tab group left the group discontiguous
- **fixed** — Fixed a spurious offer to reset key reporting mode after running a command in shells that use the kitty keyboard protocol
- **fixed** — Fixed the tab group outline in the Tahoe theme where the top and bottom lines, the outline around the group chip, and the rounded end caps were partly or fully missing
- **fixed** — Fixed a faint vertical line that could appear inside a selected tab in the dark Tahoe theme

September 10, 2026.

Improvements:
- Newlines embedded in a completion suggestion
  (such as a command-history entry or file name)
  now show as a return glyph so the entry stays
  on one line instead of spilling across rows.
  The value inserted when you accept the row is
  unchanged.

Bug Fixes:
- Fixed a crash on launch when restoring saved
  sessions that contained right-to-left text
  written by version 3.6.11. This could force you
  to discard all of your restored sessions.
- Fixed a memory leak where browser panes were
  never freed, leaking a WebKit process and a
  system power-management handle on every page
  load. Over time this could exhaust a
  system-wide limit and break other apps that
  manage power (such as OrbStack).
- Fixed a bug where navigating between tmux
  sessions or windows could freeze the UI for
  several seconds.
- Fixed dragging a file out of a session that
  failed when the terminal app used kitty's
  drag-and-drop protocol.
- Fixed cmd-clicking a URL at the end of a line
  in a full-screen app (such as irssi or mutt),
  which could open the URL with text from the
  next line appended.
- Fixed AI tool calls failing with Ollama when a
  tool used a non-string argument such as a
  number or boolean.
- Fixed a bug where a Python script that created
  a window and immediately read its current tab
  or session got nothing back, which broke
  scripts that split panes or changed the font of
  a freshly created window.
- Fixed Duplicate Tab so a tab duplicated from a
  tab group stays in that group instead of being
  left as a stray one-tab group.
- Fixed a bug where removing a tab from the
  middle of a tab group left the group
  discontiguous.
- Fixed a spurious offer to reset key reporting
  mode after running a command in shells that use
  the kitty keyboard protocol, such as Fish 4.
- Fixed the tab group outline in the Tahoe theme,
  which was being clipped: the top and bottom
  lines, the outline around the group chip, and
  the rounded end caps of the first or last group
  in the tab bar were partly or fully missing.
- Fixed a faint vertical line that could appear
  inside a selected tab in the dark Tahoe theme.

### 3.7.0 — Version 3.7.0

- Date: 2026-09-08
- Version: 3.7.0
- Original notes: https://iterm2.com/appcasts/full_changes.txt
- Permalink: https://whatsnew.fyi/product/iterm2/releases/3.7.0
- Labels: Platforms: macOS

- **added** — New iOS companion app iTerm2 Buddy that pairs with Mac via QR code for AI chat interaction over encrypted connection
- **added** — Orchestration feature allowing AI chat to view all sessions and operate iTerm2 programmatically
- **added** — Session Status system with custom subtitles, colors, and dot icons controllable via control sequence, it2 command, or triggers
- **added** — Claude Code integration with Session Status support and Workflows feature for code review and diffs
- **added** — Session Notes as floating, draggable, resizable, collapsible multiline text notes that persist across restarts
- **added** — Workgroups feature to define transformations of sessions into clusters with split panes, tabs, or peers
- **added** — Tab groups allowing Chrome/Firefox-style tab organization with named and colored chips
- **added** — Make Screenshot menu item to create screenshots with highlights and redactions
- **added** — Session archives with Save Archive and Restore Archive commands and automatic archival on session close
- **added** — Right-to-left script support with bidi reordering and Arabic and Persian cursive joining enabled by default
- **added** — Support for double-width and double-height lines via DECDWL, DECDHL, DECSWL escape sequences
- **added** — Custom in-terminal buttons with SF Symbol icons that emit user-defined escape codes via OSC 1337
- **added** — Control sequence to programmatically fold and unfold blocks of output via OSC 1337 UpdateBlock
- **added** — SetProfileProperty control sequence to change profile properties at runtime via OSC 1337
- **added** — OSC 52 clipboard query responses working with tmux 3.6+ in tmux integration
- **added** — OSC 21337 control sequence for session status with indicator, status text, and status color
- **added** — Smooth-typing animation for underscore and vertical-bar cursors in Settings
- **added** — Relative timestamps with Go-style unit suffixes such as +1m23s and +2h5m for sub-minute precision
- **added** — Fold All menu item to fold everything except folds at very top of history
- **added** — Support for Kitty drag-and-drop protocol allowing programs to accept dropped files, text, and images
- **added** — Clippings side panel for storing temporarily needed text formatted as markdown

Major New Features:
- Companion App: a new iOS app, iTerm2 Buddy,
  pairs with your Mac by scanning a QR code
  (iTerm2 > Companion Device Settings) and
  connects over an encrypted Noise channel so you
  can interact with iTerm2 via AI chat from your
  phone.
  Devices connect through an encrypted relay, so
  they work even when the Mac and phone are on
  different
  networks, and end-to-end encryption ensures that
  your data is only visible to you.
  First-time setup is now a guided wizard: it
  installs the AI and companion plugins, turns on
  both features with a single password prompt,
  takes your API key, and walks you through
  pairing your phone.

- There's a new kind of AI chat called
  "orchestration" which can view all your
  sessions and operate iTerm2 for you.

- A new Session Status system was added. Sessions
  can now report status that appears on their tab
  with a custom subtitle, color, and dot icon.
  Status can be set by a control sequence, the it2
  command, or by triggers. The Session Status tool
  lets you view the status of all sessions in a
  window at a glance and the new Cockpit window
  lets you browse status across windows.

- Claude Code integration was added. It enables
  the new Session Status feature for claude code
  sessions so you can see at a glance which
  instance is waiting for you. It also ties in
  with the new Workflows feature to facilitate
  viewing diffs and performing code reviews. It
  ties in with clippings so that AI-authored code
  review comments can easily be sent back to
  Claude code.

- Session Notes were added: floating,
  draggable, resizable, collapsible multiline
  text notes attached to a session that
  persist across restarts.

- The new Workgroups feature let you define how to
  transform a session into a cluster of related
  sessions. When a session enters a Workgroup, the
  cluster of related sessions is created. They can 
  be in split panes, separate tabs, or "peers"
  which are like tabs within a split pane.
  Sessions in a workgroup have a unique name, a
  custom command, a customizable toolbar, and can
  even have custom behavior such as to drive AI
  code review or perform in-terminal diffs of a
  git repo.
  When a Workgroup spawns extra tabs, they are
  now collected into a tab group together with
  the session you entered from, and each spawned
  split or tab takes the name you gave it in the
  Workgroup so its tab title is recognizable.

- Added tab groups: right-click a tab and choose
  Add Tab to Group to group Chrome/Firefox-style
  tabs. A named, colored chip heads each group;
  right-click it to rename, recolor, duplicate,
  move to a new window, ungroup, or close the
  group. Drag the chip to move the whole group,
  within a window or into another one; drag
  single tabs into, around, or out of a group.
  Groups persist their name and color with the
  member tabs.

- You can now create screenshots including
  highlights and redactions using the Make
  Screenshot menu item.

- Session archives were added. The new Session >
  Archives menu has “Save Archive of Current
  Session…” and “Restore Archive…” commands, and
  remembers your ten most recent archives. A
  per-profile setting can automatically archive a
  session to a configured directory when it
  closes.  Restoring an archive reopens the
  session’s scrollback in a new window.

New Features in Terminal Sessions:
- Right-to-left script support (bidi
  reordering plus Arabic and Persian
  cursive joining) is now enabled by
  default. You can turn it off in
  Settings > General > Experimental.
- Double-width and double-height lines
  (DECDWL, DECDHL, DECSWL) are now supported
  via ESC #3, #4, #5, and #6.
- Custom in-terminal buttons with SF Symbol
  icons that emit a user-defined escape code
  when clicked. To add one, send
  OSC 1337 ; Button=type=custom;code=N;
  icon=<SF-Symbol-name> ST. The code must be
  positive. To invalidate all custom buttons,
  send OSC 1337 ; Button=type=custom ST

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

### 3.7.0beta12 — Version 3.7.0beta12

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

- **changed** — iTerm2 uses far less memory and CPU when a full-screen program repaints the screen rapidly, such as a TUI or an AI agent that redraws every frame, fixing runaway memory growth that could reach several gigabytes
- **changed** — When you enter a Workgroup, its tabs are now gathered into one tab group and given the names from the Workgroup configuration, and leaving the Workgroup restores the tab you started from to its previous name and group
- **added** — A new tab opened next to a tab that belongs to a tab group now joins that group
- **added** — Tab group menu gained a New Tab in Group command
- **added** — Tab Groups gained Window menu commands Select Next Tab Group and Select Previous Tab Group, plus Add Tab to New Group and Remove Tab from Group
- **changed** — The Password Manager now has a single Edit panel that changes an entry's name, user name, and password, available whenever a row is selected
- **added** — You can now create and edit 1Password entries from the Password Manager, with the password sent securely and never appearing on the command line, requiring 1Password command-line tool version 2.23 or later
- **changed** — The Keeper backend now supports Nested Shared Folders alongside the classic vault, both in one list labeled (Classic) or (Nested), with an Add Account panel offering a Use classic permission model choice
- **changed** — In AI chat, a session reference the assistant writes without a leading @ now renders as a clickable session link
- **fixed** — Programs that ask whether iTerm2 is in light or dark mode via the DSR 996 query now receive a reply
- **fixed** — Right-to-left text no longer scrambles when a full-screen program scrolls part of the screen, and wrapped right-to-left lines shown from scrollback keep their correct display order
- **added** — Added new Allow HDR effects advanced setting to gate the selected tab's bright HDR outline on macOS Tahoe, which is off by default to prevent display hangs on some systems
- **fixed** — Fixed various crashes

Changes since 3.7.0beta11:

Improvements:
- iTerm2 uses far less memory and CPU when a
  full-screen program repaints the screen
  rapidly, such as a TUI or an AI agent that
  redraws every frame. This fixes runaway
  memory growth that could reach several
  gigabytes. Issue 12992.
- When you enter a Workgroup, its tabs are now
  gathered into one tab group and given the
  names from the Workgroup configuration, so
  they are easy to tell apart. Leaving the
  Workgroup restores the tab you started from to
  its previous name and group. Issue 12967.
- A new tab opened next to a tab that belongs to
  a tab group now joins that group, so it stays
  with the set you are working in. The tab group
  menu also gained a New Tab in Group command.
- Tab Groups gained Window menu commands: Select
  Tab > Select Next Tab Group (⌃⇧⌘]) and Select
  Previous Tab Group (⌃⇧⌘[), plus Add Tab to New
  Group and Remove Tab from Group. The selection
  commands skip over the rest of a group. For
  an ungrouped tab they behave like Select
  Next/Previous Tab.
- The Password Manager now has a single Edit
  panel that changes an entry's name, user name,
  and password, available whenever a row is
  selected. On backends that support it the edit
  is made in place, so renaming an entry keeps
  its other fields, such as one-time passwords,
  intact.
- You can now create and edit 1Password entries
  from the Password Manager. The password you
  choose is sent securely and never appears on
  the command line. This needs the 1Password
  command-line tool version 2.23 or later.
- The Keeper backend now supports Nested Shared
  Folders alongside the classic vault, both in
  one list labeled (Classic) or (Nested), and
  the Add Account panel offers a “Use classic
  permission model” choice.
- In AI chat, a session reference the assistant
  writes without a leading @ now still renders
  as a clickable session link.

Bug Fixes:
- Programs that ask whether iTerm2 is in light
  or dark mode (the DSR 996 query) now receive
  a reply. The query was being ignored, so
  tools that check it before drawing, such as
  delta, saw no response.
- Right-to-left text no longer scrambles when a
  full-screen program scrolls part of the
  screen, and wrapped right-to-left lines shown
  from scrollback keep their correct display
  order.
- The selected tab's bright HDR outline on
  macOS Tahoe is now off by default. It is
  gated behind a new “Allow HDR effects”
  advanced setting because forcing the display
  into HDR could hang some systems.
- Fixed various crashes.

### 3.7.0beta11 — Version 3.7.0beta11

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

- **changed** — Scrollable tab bars are now enabled by default, with tabs that do not fit staying in the bar and reached by scrolling instead of the More tabs overflow menu
- **changed** — Built-in AI model list now includes Claude Sonnet 5, GPT-5.6, and Gemini 3.x flash models, with recommended defaults updated to GPT-5.6 for OpenAI and Gemini 3.7 Flash for Gemini
- **removed** — Retired AI models Opus 4.1 and Gemini 2.0 flash are removed from the model list
- **added** — Settings > General > AI now includes an Automatically update available AI models checkbox and an Update Now button to refresh the model catalog from iterm2.com
- **added** — Legacy script Python version upgrade warning now includes an Upgrade Now button to migrate affected scripts immediately
- **changed** — The tmux Dashboard's Open in Tabs button now works with a single selected window, matching the Open in Window behavior
- **fixed** — Fixed several AI chat request bugs on the OpenAI Responses API including bare context delivery and user message dropping on turns after the first
- **fixed** — Fixed AI tool schemas being rejected with HTTP 400 under strict mode and JSON null values in arrays crashing the response parser
- **fixed** — Selected tab in a scrollable tab bar no longer paints over the tab bar's rounded border
- **fixed** — On macOS Tahoe, the tab bar overflow menu no longer drops the first hidden tab
- **fixed** — Cmd-W now closes the Companion Device Settings window instead of beeping
- **fixed** — Companion Device Settings window no longer fires the Touch ID or password prompt on its own when opened or after unpairing
- **changed** — Dropping a local file on the terminal no longer offers to upload it over scp when the machine answers to multiple names
- **fixed** — Fixed various crashes
- **added** — Companion Device Settings window shows a Show QR Code button and authenticates only after clicking it

Changes since 3.7.0beta10:

Improvements:
- Scrollable tab bars are now on by default. Tabs
  that don't fit stay in the bar and are reached
  by scrolling instead of the "More tabs" overflow
  menu. You can turn this off in Settings.
- The built-in AI model list now includes Claude
  Sonnet 5, GPT-5.6, and the Gemini 3.x flash
  models, and the recommended defaults move to
  GPT-5.6 for OpenAI and Gemini 3.7 Flash for
  Gemini. Retired models (Opus 4.1, Gemini 2.0
  flash) are removed.
- Settings > General > AI has a new "Automatically
  update available AI models" checkbox and an
  Update Now button. The model catalog can refresh
  itself from iterm2.com so new models appear
  without updating iTerm2; these controls let you
  turn the automatic check on or off and run a
  check on demand.
- The startup warning that a legacy script's
  pinned Python version will be bumped for the uv
  runtime now has an Upgrade Now button that
  migrates the affected scripts immediately, so a
  script you never launch no longer re-nags every
  launch.
- The tmux Dashboard's Open in Tabs button now
  works with a single selected window, matching
  Open in Window. Issue 12994.
- Dropping a local file on the terminal no longer
  offers to upload it over scp when your machine
  answers to more than one name (for example a
  .local name versus a DHCP-assigned name).

Bug Fixes:
- Fixed several AI chat request bugs on the
  OpenAI Responses API: every turn after the
  first could reach the model as bare context
  with the user's newest message dropped; some
  tool schemas were rejected with an HTTP 400
  under strict mode; and a JSON null inside an
  array could crash the response parser.
- A selected tab in a scrollable tab bar no
  longer paints over the tab bar's rounded
  border.
- On macOS Tahoe, the tab bar overflow menu no
  longer drops the first hidden tab: with one
  hidden tab the chevron opened an empty menu,
  and with more the first was missing.
- Cmd-W now closes the Companion Device Settings
  window instead of beeping.
- The Companion Device Settings window no longer
  fires the Touch ID / password prompt on its
  own when opened or after unpairing. It shows a
  "Show QR Code" button and authenticates only
  after you click it.
- Fixed various crashes.

### 3.7.0beta10 — Version 3.7.0beta10

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

- **changed** — Require macOS 13 (Ventura) or later; macOS 12 is no longer supported
- **added** — Tab groups that can be named, colored, collapsed, expanded, and dragged within or between windows
- **added** — Kitty terminal drag-and-drop (OSC 72) support for accepting dropped files and dragging content to other apps
- **added** — Scrollable left/right (vertical) tab bar that keeps tabs in the bar instead of using an overflow menu
- **changed** — The uv-based Python runtime is now enabled by default for newly created, imported, and migrated API scripts
- **added** — Per-profile "Use ANSI colors for marks" setting to draw command-prompt mark indicators using color preset's ANSI colors
- **added** — Keyboard toggle for the Advanced Paste indicator to switch between waiting for shell prompt and sending keystrokes directly
- **changed** — Key binding matching now offers to enable "Interpret key bindings based on physical key" when a keystroke matches by physical key but not character
- **changed** — Confirmation dialog for closing a workgroup session now warns that peers and their tabs will also close
- **changed** — ConEmu progress protocol's paused state (OSC 9;4;4) is now honored even when the percentage is omitted
- **fixed** — Restoring a session whose saved working directory no longer exists no longer silently closes the tab
- **fixed** — Decomposed Hangul jamo are now recomposed into a single cell instead of being split into separate cells
- **fixed** — The 16th parameter of an SGR trigger is no longer dropped
- **fixed** — Toolbelt list tools (Command History, Recent Directories, Captured Output) no longer draw their rows at zero width when a window opens with the toolbelt showing
- **fixed** — On macOS Tahoe dark themes, selected left/right tab chrome is drawn at the tab's real height instead of a fixed cap-image height
- **fixed** — The top-right session indicators no longer smear while swiping between tabs
- **fixed** — Fixed a window leak from the frame canonicalizer
- **fixed** — A workgroup no longer shows a blank pane when it tears down while a non-main peer is on screen
- **fixed** — A peer host's toolbar now refreshes after its nested port is wired
- **fixed** — Fixed word-boundary punctuation typos in the default settings

This version requires macOS 13 (Ventura) or later.
macOS 12 is no longer supported. Sorry for the
inconvenience!

New Features:
- Tab groups. Select tabs and gather them into a
  named, colored group marked by a chip on the
  tab bar. Groups stay contiguous, can be
  collapsed and expanded with an animation, and
  can be dragged as a unit within a window or out
  to a new or existing window. A right-click chip
  menu and a Firefox-style "Add Tab to Group" tab
  menu let you rename, recolor, close, or ungroup.
  Works on horizontal and vertical tab bars.
- Kitty terminal drag-and-drop (OSC 72). Programs
  that speak the protocol can accept files dropped
  onto the terminal window and can start a drag of
  their own content out to other apps, including
  across an SSH connection when using it2ssh.
- The left/right (vertical) tab bar can now be
  made scrollable: turn on the new setting and
  tabs that don't fit stay in the bar and are
  reached by scrolling instead of the "More tabs"
  overflow menu. This also works on horizontal
  tab bars.
- The uv-based Python runtime is now on by
  default. Newly created, imported, and migrated
  API scripts get a faster, self-managing
  interpreter instead of the bundled Python
  runtime. You can still override this in Advanced
  Settings, and already-provisioned scripts are
  unaffected.

Improvements:
- A new per-profile "Use ANSI colors for marks"
  setting (Profiles > Colors, off by default)
  draws command-prompt mark indicators using the
  color preset's ANSI blue, red, and yellow so
  they harmonize with your theme.
- The Advanced Paste indicator now has a keyboard
  toggle so you can switch a running paste between
  waiting for the shell prompt and sending
  keystrokes straight through, which lets you
  answer a password or other non-standard prompt
  mid-paste. Issue 5749.
- When a keystroke with a modifier matches no key
  binding by character but does match one for the
  same physical key (for example after switching
  keyboard layout or when an input method changes
  the character a key reports), iTerm2 now offers
  to turn on "Interpret key bindings based on
  physical key".
- The confirmation for closing a workgroup session
  now warns that the rest of the workgroup, its
  peers and their tabs, will close too.
- The ConEmu progress protocol's paused state
  (OSC 9;4;4) is now honored even when the
  percentage is omitted. Issue 723.

Bug Fixes:
- Restoring a session whose saved working
  directory no longer exists (for example a
  network drive that is not mounted at launch) no
  longer fails to relaunch the shell and silently
  closes the tab. Issue 12955.
- Decomposed Hangul jamo are now recomposed into a
  single cell instead of being split into separate
  cells. Issue 3063.
- The 16th parameter of an SGR trigger is no
  longer dropped by an off-by-one in the parameter
  store. Issue 722.
- Toolbelt list tools (Command History, Recent
  Directories, Captured Output) no longer draw
  their rows at zero width when a window opens
  with the toolbelt showing. Issue 12964.
- On macOS Tahoe dark themes, selected left/right
  tab chrome is drawn at the tab's real height
  again instead of a fixed cap-image height, so a
  custom tab bar height looks right. Issue 715.
- The top-right session indicators no longer smear
  while swiping between tabs.
- Fixed a window leak from the frame
  canonicalizer.
- A workgroup no longer shows a blank pane when it
  tears down while a non-main peer is on screen,
  and a peer host's toolbar now refreshes after
  its nested port is wired.
- Fixed word-boundary punctuation typos in the
  default settings. Issue 720.
- Fixed two format-string bugs in logging calls.
  Issue 712.
- Fixed various crashes.

### 3.7.0beta9 — Version 3.7.0beta9

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

- **added** — Add Suppressed Alerts panel that lists warnings you silenced with "remember my choice" so you can turn them back on
- **added** — Add manual AI model editor with one-tap presets for OpenAI-compatible providers (Ollama, OpenRouter, z.ai, Qwen, MiniMax) and a Test Connection button
- **changed** — Web URLs handed to iTerm2 now open in the built-in web browser instead of launching a terminal, unless you have bound the scheme to a specific profile
- **added** — Add Copy URL option when right-clicking an auto-detected URL to remove hard line breaks from wrapped URLs
- **changed** — Enable right-to-left script support (bidi reordering plus Arabic and Persian cursive joining) by default
- **changed** — AI chat history is now replayed to the model from the exact bytes previously sent rather than rebuilt each turn to keep the prompt cache valid
- **added** — Add Zero Data Retention setting under Settings > General > AI to stop sending previous_response_id and set store=false
- **changed** — AI chat linked to a terminal session can now watch that session and tell you when it reaches a described state or condition
- **changed** — ⌘-click now linkifies very long URLs in full, scanning to the next separator and handling internationalized (IDN) hostnames
- **changed** — When AI chat types into a terminal with the insert-at-cursor tool, a newline is now sent as Return so it submits the line
- **changed** — Preferences search now finds several Colors-tab settings such as Border around active pane, Use custom tab color, and light/dark color controls
- **added** — Add Clear Terminated button to Script Console that removes stopped script and connection entries
- **changed** — A new tmux window opened with ⌘T now picks up the profile's custom tab title, if one is set
- **changed** — iTerm2 now probes the local network on every launch so macOS keeps it in the Local Network privacy list
- **changed** — Faster rendering of text with many colors by reusing attribute dictionaries across color spans instead of rebuilding one per span
- **fixed** — Fix local privilege issue where the orphaned-session server adopter connected to a socket without checking ownership, allowing man-in-the-middle attacks
- **fixed** — Fix authenticated Python API client ability to exhaust iTerm2's memory by flooding it with WebSocket ping frames by bounding inbound buffering
- **fixed** — Fix sixel image whose String Terminator was written as ESC ESC \ instead of ESC \ being discarded with a stray backslash
- **fixed** — Fix ⌘-click to again open files in JetBrains IDEs by invoking the launcher directly
- **fixed** — Fix toggling Caps Lock under the Kitty keyboard protocol with "report all keys as escape codes" no longer sending an "A"

Changes since 3.7.0beta8:

Heads up: future betas will require macOS 13
(Ventura) or later. This is the last version to
support macOS 12. Sorry for the inconvenience!

New Features:
- iTerm2 > Suppressed Alerts is a new panel that
 lists warnings you silenced with "remember my
 choice" so you can turn them back on. For
 example, answering No and checking the box on
 the prompt that asks before displaying a
 terminal-initiated image silently disabled all
 inline images with no obvious way to undo it;
 now you can find that choice and clear it. The
 old "Always Show Alerts with Remembered
 Selections" command moves into this panel.
 Issue 12963.
- The manual AI model editor now offers one-tap
 presets for OpenAI-compatible providers
 (Ollama, OpenRouter, z.ai, Qwen, MiniMax) that
 fill in the endpoint for you, plus a Test
 Connection button that verifies your settings
 and API key before you save.

Improvements:
- Web URLs handed to iTerm2 (by the OS as your
 default browser, by "open -a iTerm2 ", by
 Velja, or by vim's gx) now open in the built-in
 web browser instead of launching a terminal,
 unless you have bound the scheme to a specific
 profile. If the browser plugin is not
 installed, iTerm2 offers it once. Issue 12431.
- Right-clicking an auto-detected URL (the kind
 ⌘-click opens) now offers Copy URL, which
 removes the hard line breaks from a wrapped URL
 so a clean link lands on the clipboard.
 Issue 12944.
- Right-to-left script support (bidi reordering
 plus Arabic and Persian cursive joining) is now
 enabled by default. You can turn it off in
 Settings > General > Experimental. Issue 4361.
- AI chat history is now replayed to the model
 from the exact bytes previously sent rather
 than rebuilt each turn, so the prompt cache
 stays valid across turns (including turns that
 ran a tool) and long conversations keep getting
 cheaper and faster.
- Added a Zero Data Retention setting under
 Settings > General > AI. Turn it on if your
 OpenAI organization has Zero Data Retention
 enabled. iTerm2 then stops sending
 previous_response_id and sets store=false, so
 chats no longer fail on the second message.
 Issue 12521.
- An AI chat linked to a terminal session can now
 watch that session and tell you when it reaches
 a described state or condition, without
 polling. Previously only orchestration chats
 could set watches.
- ⌘-click now linkifies very long URLs in full.
 Previously only the first couple thousand
 characters were clickable; the linkifier now
 scans onward to the next separator, handles
 internationalized (IDN) hostnames, and no
 longer joins a URL to unrelated text across a
 hard line break.
- When AI chat types into a terminal with the
 insert-at-cursor tool, a newline is now sent as
 Return so it submits the line in programs like
 Claude Code instead of inserting a literal
 newline.
- Preferences search now finds several Colors-tab
 settings that were previously unsearchable,
 such as Border around active pane, Use custom
 tab color, and the light/dark color controls.
- The Script Console has a Clear Terminated
 button that removes stopped script and
 connection entries, so it no longer grows
 without bound (and slows the app) when you
 repeatedly restart a script. Issue 12942.
- A new tmux window opened with ⌘T now picks up
 the profile's custom tab title, if one is set.
- iTerm2 now probes the local network on every
 launch so macOS keeps it in the Local Network
 privacy list. This recovers the permission
 after a tccutil reset or an OS upgrade, fixing
 commands like "ping 10.0.0.1" failing with "no
 route to host". Issue 12956.
- Faster rendering of text with many colors (such
 as syntax-highlighted code) by reusing
 attribute dictionaries across color spans
 instead of rebuilding one per span. Issue
 12763.

Bug Fixes:
- Fixed a local privilege issue where the
 orphaned-session server adopter connected to a
 socket in a world-writable directory without
 checking who owned it. A local attacker could
 pre-c

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

### 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.