docs/notes-3.7.0beta8.txt

Rama master · réplica de lectura del repositorio original.

Version 3.7.0beta8 was built on July 26, 2026.

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.