docs/notes-3.7.7beta1.txt

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

Version 3.7.7beta1 of iTerm2 was built on October
16, 2026.

New Features:
- Floating Panes: a pane that floats over a tab’s
  split panes. Create one with Shell > New
  Floating Pane with Current Profile, or with a
  key binding or pointer action. Drag its title
  bar to move it and its edges to resize it. Hold
  Control while dragging to dock it into the split
  panes or move it to another tab or window.
  Window > Floating Panes can raise, dock, move,
  and hide them. They are saved with window
  arrangements. tmux integration shows tmux’s own
  floating panes (tmux 3.7 and later; moving,
  resizing, raising, and docking them needs tmux
  3.8).
- Support for the Program Status Protocol (OSC
  7501), which lets a program report that it is
  working, waiting on you, done, or failed. The
  tab shows the most urgent status the program
  reported, along with its message and progress. A
  program reporting on several tasks at once gets
  them listed under its session in the Session
  Status tool, and each task that needs you can
  post its own notification.
- Session Status has new “done” and “error”
  statuses for work that finished or failed while
  you were away. They sort just below “waiting”
  and above “working”, and “idle” now sorts last.
  Pressing a key in the session marks the result
  as seen and turns it idle. Claude Code and Codex
  now report a finished turn as “done” and an API
  error as “error”.
- iTerm2 can now warn you while you are away from
  your Mac without cutting off your paired iPhone.
  The iTerm2 Buddy app stays connected, shows the
  warning, and lets you answer it, including
  “don’t ask again” and password prompts. Other
  kinds of dialogs can’t be answered from the
  phone, but it now says the Mac is waiting
  instead of appearing disconnected. Requires an
  up-to-date iTerm2 Buddy.
- Passwords saved in the Password Manager’s
  Keychain storage can now be exported to a
  passphrase-encrypted .iterm2passwords file and
  imported on another Mac. Use Export Passwords…
  and Import Passwords… in the Password Manager’s
  settings menu, or double-click the file.
  Settings > General > Export All Settings and
  Data can also include them.
- Each profile can now choose its bell sound in
  Settings > Profiles > Terminal > Bell sound.
  Pick a sound installed on your Mac or choose
  “Other…” for any audio file.
- If a profile archives sessions when they close
  (Settings > Profiles > Session), Undo Close
  keeps working after its time limit runs out.
  Archived sessions come back in their original
  split panes, tabs, and windows. The last 20 can
  be undone even after restarting iTerm2.
- New setting in Settings > Appearance > General
  shows an iTerm2 icon in the menu bar, optionally
  followed by an interpolated string such as
  \(iterm2.workingSessionCount).
- New variables iterm2.workingSessionCount and
  iterm2.waitingSessionCount count the sessions
  whose status is “working” or “waiting”. Use them
  anywhere interpolated strings work, such as
  badges, tab titles, and the status bar.
- nushell is now supported by shell integration,
  including automatic loading and SSH integration.
- Apps can now control right-to-left text
  reordering with the BDSM and SCP escape
  sequences. CSI 8 l enters explicit mode, in
  which text is drawn exactly as written, and CSI
  8 h returns to implicit mode. CSI 1 SP k and CSI
  2 SP k make reordered lines left-to-right or
  right-to-left, and CSI 0 SP k restores the
  default.
- You can hide a browser session’s toolbar so the
  page fills the pane with Web > Show Toolbar.
- Right-clicking a tab now offers Rename Tab.
- “it2 session list” takes a --format option: an
  interpolated string evaluated in each session,
  such as '\(session.path)'.

Other Improvements:
- The built-in AI model list is up to date. It
  adds GPT-6 Astra, GPT-6.1 Sol, GPT-6 Sol, GPT-6
  Luna, GPT-5.4 Pro, GPT-5.4 mini, Gemini 3.8
  Flash, DeepSeek Flash (V4.1), Claude Opus 5.5,
  Claude Sonnet 5.5, Claude Fable 5.1, Claude Opus
  5, and Claude Fable 5, and the recommended model
  for each provider is now its newest flagship.
  Newer Claude models also get their full 1
  million token context window. o4-mini, which
  OpenAI is shutting down, has been removed.
- The manual AI model editor has a new API key
  setting. It can send one provider’s stored key,
  a key entered just for that model, or no key.
  Automatic, the default, sends a provider’s key
  only to that provider’s own servers, so a
  gateway such as OpenRouter no longer gets your
  OpenAI key unless you choose it. Models you
  already set up keep sending the key they sent
  before. Issue 13105.
- Uploads over SSH Integration are about three
  times faster.
- “Upload and Paste Path” now works in tmux
  integration windows reached through SSH
  Integration, and before shell integration has
  reported a directory, in which case the file
  goes to your home directory. Pasted screenshots
  are converted from TIFF to PNG and each one gets
  a unique name.
- Focus Follows Mouse no longer takes focus away
  from the find bar, composer, or other fields in
  a pane by accident. To have focus follow the
  pointer onto those views, turn on “…even to
  views like Search or Composer” under Settings >
  Pointer.
- “Support basic HTML tags in tab titles” now
  applies to pane title bars too. The window title
  shows the text without the tags.
- Pausing a spinning progress indicator with OSC
  9;4;4 now shows a paused spinner instead of a
  yellow bar at 10%.
- iTerm2 no longer applies macOS’s automatic
  spelling correction, capitalization, smart
  quotes and dashes, or “Add period with
  double-space”. They could change what you type
  in a terminal. Text replacements still work.
  Issue 13123.
- With the Minimal or Compact theme and no tab bar
  at the top, the window buttons that appear when
  you point at the window’s top-left corner no
  longer cover a status bar, Workgroup toolbar, or
  a web browser’s navigation buttons. A small
  arrow appears in the corner instead; click it to
  show or hide the window buttons. Issue 13100.
- The Companion setup wizard no longer asks for an
  API key when AI already works, or when you chose
  a model manually in Settings > General > AI.
- Pairing a companion iPhone no longer fails on
  networks that can’t reach iterm2.com. iTerm2 now
  falls back to a second copy of its list of relay
  servers.
- The Script Console now keeps only the 200 most
  recent finished scripts and API connections.
  Tools that connect for each command, like it2,
  used to pile up enough of them to slow iTerm2
  down over time.
- The Bitwarden, KeePassXC, and Keeper password
  manager integrations now find command-line tools
  installed by Homebrew or npm by using your
  shell’s search path. The Bitwarden integration
  now reports the Bitwarden CLI’s own error
  message, and says so when your vault has no
  folder named “iTerm2”.
- The AI Usage toolbar item now finds claude using
  your shell’s search path and respects
  CLAUDE_CONFIG_DIR set in your shell startup
  files.
- AI chat asks for approval less often when it
  types a message you dictated into another
  session.
- When an AI chat’s Stop button or Disable
  Orchestration cancels pending timers or watches,
  the chat now says so.
- Opening an Instant Replay recording now only
  applies appearance settings like colors, fonts,
  and cursor style from it. Settings that could
  run commands, such as triggers, are ignored.
  Issue 13128.
- Installing or reinstalling the Claude Code
  Integration no longer replaces a settings.json
  that has a syntax error, keeps a symlinked
  settings.json as a symlink, and keeps hook
  commands you edited to use $HOME, ~, or a
  wrapper script. Issue 13098.
- Debug logs no longer include passwords, password
  field contents, AI API keys, or custom AI HTTP
  header values.
- iTerm2 now warns you if another copy of it is
  already running with the same settings, and
  offers to switch to it.
- Restorable session state is again saved with
  SQLite’s write-ahead logging, reducing disk
  syncing, and the restorable-state.sqlite-wal
  file no longer grows as large as the saved state
  itself.
- Installing shell integration without internet
  access now works on systems without bash, such
  as FreeBSD and OpenBSD, and no longer gets stuck
  at its first step for zsh users.

Bug Fixes:
- Fixed various crashes, including ones involving
  the GPU renderer (when switching to or from
  battery power, after changing the font size,
  after closing a session, or after running for
  several weeks), Smart Selection rules or
  triggers with no regular expression, Dynamic
  Profiles with values of an unexpected type,
  quitting while still starting up, fonts that
  could not be measured, accessibility apps like
  VoiceOver, splitting a pane that moved, tab
  groups, tmux integration windows left open after
  detaching, exiting full screen in a window
  without a title bar, Find, “Import All Settings
  and Data”, Set Profile Setting triggers, profile
  names starting with a combining mark, and
  Cmd-hovering over a composer autosuggestion.
  Issue 13103.
- Fixed a crash that could recur every time iTerm2
  saved window state after quitting while a save
  was in progress.
- Fixed saving a window arrangement with “Save to
  File with Contents…” and archiving a session
  when the text contained hyperlinks or similar
  styling. Issue 13143.
- Restarting or logging out of macOS while Claude
  Code was running in iTerm2 could cause your
  windows not to be restored at the next login.
- Quitting iTerm2 no longer unlinks each AI chat
  from its terminal session or cancels what the
  chat was watching when window restoration brings
  the session back.
- A program that sets the window or tab title over
  and over no longer makes iTerm2 fall far behind,
  use full CPU for minutes, and grow to gigabytes
  of memory.
- When an SSH Integration connection dropped, the
  session hung. It now ends the connection and
  returns to the local shell. Long SSH Integration
  requests also no longer occasionally fail.
- In a session that ssh’ed to another machine
  without SSH Integration, the current directory
  no longer switches to the local Mac’s directory
  after you run a command.
- Fixed a rare race where a new session could lose
  some of the first output it received.
- Fixed restored sessions bringing lines that had
  been erased by a clear screen back onto the
  screen.
- In “Require Authentication on Every Open” mode,
  the password manager no longer shows your
  accounts without asking you to authenticate when
  reopened. In “Once per Launch and after Screen
  Locks” mode, locking the screen now always
  requires authenticating again.
- An AI chat set to Llama (Local) no longer sends
  its messages to your cloud AI provider when no
  Ollama model is available.
- Stopping an AI chat reply no longer cancels
  another chat’s reply, really stops downloading,
  and no longer shows the rest of the stopped
  reply as the answer to your next message.
- Editing or deleting an AI chat message now fully
  removes the later conversation.
- Fixed a memory leak where each AI request left
  memory in use until iTerm2 quit.
- AI command suggestions that use a file name now
  insert the whole file name instead of only the
  part you hadn’t typed yet.
- Fixed “Export All Settings and Data” failing
  with “Failed to copy file” after using SSH
  Integration.
- Archive Sessions on Closure failed with “the
  volume is read only” when no archive folder was
  chosen. It now uses ~/Library/Application
  Support/iTerm2/Archives. Issue 12980.
- Fixed archiving of split panes with the same
  name, and of sessions closed shortly before
  quitting.
- Pasting or dropping a file into a local tab no
  longer offers only to upload it when another
  tool reports an outdated host name. Issue 13117.
- Semantic History can once again open files in
  Xcode when the active developer directory is the
  Command Line Tools. Issue 13091.
- Semantic History could open the wrong file in
  TextMate, BBEdit, or MacVim when the path
  contained special characters.
- With “Report keys using CSI u” on and Option set
  to Meta, Option with a letter now sends the meta
  byte.
- Old key bindings no longer hijack the A key when
  “Interpret key bindings based on physical key”
  is on. Issue 13110.
- The “Animate large movements” cursor option no
  longer streaks a trail across the screen when a
  program redraws on its own. Issue 13034.
- Find now matches text that spans a blank the
  program created by moving the cursor, as in
  output from Claude Code.
- Copying part of a line that mixes left-to-right
  and right-to-left text no longer drops the space
  between them.
- With the GPU renderer off, a right-to-left word
  whose letters had different colors no longer
  draws in a single color.
- The Prevent Sleep checkbox in Settings >
  Profiles > Session now takes effect, and Prevent
  Sleep is honored again after Restart Session and
  Undo Close.
- In tmux integration, a new pane now picks up
  user variables, host name, and directory that
  its shell reported while opening. Issue 13006.
- In tmux integration, a window created with “tmux
  new-window -d” now opens as a background tab.
  Issue 13112.
- In tmux integration, iTerm2 could miss a window
  switch made by another client and keep showing
  the old tab.
- Answering “Always” to “Close tmux windows after
  detaching?” now closes only the tmux windows
  left open by the detach instead of every
  session.
- Fixed Find > Filter interacting badly with tmux
  layout changes.
- Opening a file or link in a split pane while a
  tmux integration tab is current now opens it in
  a new tab.
- On macOS 26, hiding a hotkey window when no
  other iTerm2 windows are open once again returns
  focus to the previous app right away.
- Centered hotkey windows no longer return to
  their original size each time they are shown.
  Issue 13125.
- Move Tab Left/Right no longer pins or unpins a
  tab by moving it into a tab group.
- Voice Control corrections now replace text that
  ends at the cursor instead of appending.
- Cancelling an upload over SSH Integration no
  longer leaves a temporary file behind or gets
  stuck.
- In an alert with a text field, Cmd-A, Cmd-C,
  Cmd-V, Cmd-X, and Cmd-Z now edit the text.
- The SetWindowFrame escape sequence no longer
  shrinks a window to nothing or moves it off
  screen when given bad values.
- With KeePassXC as the browser password manager,
  “Remember this password” for a sign-in dialog
  now works.
- Fixed Tab.async_update_layout in the Python API
  making a browser pane far too big.
- Hiding a session note while typing in it no
  longer leaves keystrokes going nowhere.
- Fixed several Cockpit bugs: Opt-Return and
  Opt-Shift-Return sent nothing, a selection sent
  the whole field, the caret jumped while sessions
  changed status, sending after closing a chosen
  session sent nothing, and the panel could cover
  alerts.
- With multiple @-mentions and spaces in the
  Cockpit composer, the session picker now closes
  when it should.
- When settings load from a custom folder,
  quitting no longer asks to copy settings every
  time.
- Fixed a bug where turning on “Use AI to check
  safety of commands before running them” on a Mac
  without Apple Intelligence was turned back off.
- Fixed Notify on Status Change reporting a change
  from “none” or alerting when a program restated
  its status.
- The crash reporter’s message fills in your name
  again.
- Help popovers no longer cut off their last line.
- Choosing Show Session Note from Open Quickly no
  longer makes the note disappear.
- Clicking the icon of the Current Directory,
  Hostname, or Username status bar component opens
  its menu again.
- The API key field shown when AI features ask for
  a key now hides what you type.
- Closing the Companion setup wizard while it is
  installing now cancels setup.