iTerm2 3.7.7beta2

3.7.7beta2Pre-releasemacOS

Version 3.7.7beta2

Added 8
  • Workgroups now work in tmux Integration tabs, with the workgroup kept on the tmux server so it survives detaching and is picked up again when attaching, even from another Mac (requires tmux 3.2 or later)
  • When a Workgroup's main session is on a host reached through SSH Integration, its companion sessions such as Code Review now run on that host too
  • The Claude Code integration can now be installed on a host reached through SSH Integration via iTerm2 > Install Claude Code Integration, and uninstalling removes it from every connected host
  • A host reached through SSH Integration can be set to "Always Allow This Host" when it asks to use it2, so it is not asked again on later connections, and these hosts can be reviewed or removed in Settings > General > Magic > API access over ssh
  • In iTerm2 Buddy, web browser sessions show the page and support tapping, scrolling, typing, back, forward, reload, and an address field (requires an up-to-date iTerm2 Buddy)
  • While typing an @-mention in an AI chat that can control other sessions, the session can be clicked instead of picked from the list
  • The it2 session set-status command has a new --progress option that starts or stops the tab's progress indicator
  • The it2 session add-clipping and archive-clippings commands accept --tmux and --tmux-pane
Changed 20
  • SSH Integration paces output from the remote host so high-volume output no longer fills the connection's buffers, Control-C takes effect immediately, and typing stays responsive while output streams
  • Downloading a file or folder with "Download using SSH Integration" is much faster
  • On a host reached through SSH Integration, it2 is now a real command in ~/.iterm2/bin rather than a shell function, so scripts, sh -c, and tools such as Claude Code's Bash tool can run it, and commands reading standard input receive it
  • On a host reached through SSH Integration, an it2 command that names no session now acts on the session it runs in rather than the focused one
  • it2 works on a host reached through SSH Integration when the shell is tcsh and when shell integration is not loaded there
  • it2ssh loads shell integration on the remote host by default regardless of the profile's Load Shell Integration Automatically setting, and --no-shell-integration skips it; SSH profiles still follow their own setting
Fixed 1
  • Fixed crashes when searching in the AI Chats window, importing a script archive with a damaged signing certificate, finishing an SSH Integration download on a user@host connection, using a trigger in a Dynamic Profile whose parameter has an unexpected type, and when a display reports a refresh rate of 0

From iTerm2

27, 2026.

New Features:

  • Workgroups now work in tmux Integration tabs. The workgroup is kept on the tmux server, so it survives detaching and is picked up again when you attach, even from another Mac. Requires tmux 3.2 or later.
  • When a Workgroup’s main session is on a host reached through SSH Integration, its companion sessions, such as Code Review, now run on that host too.
  • The Claude Code integration can now be installed on a host reached through SSH Integration, so Claude Code running there reports its status too. Choose iTerm2 > Install Claude Code Integration from a session on that host, including a tmux Integration pane there. Uninstalling removes it from every host you are connected to.
  • When a host reached through SSH Integration asks to use it2, you can now choose “Always Allow This Host” so it is not asked again on later connections. Review or remove these hosts in Settings > General > Magic > API access over ssh.
  • In iTerm2 Buddy, web browser sessions now show the page instead of a black screen, and you can tap, scroll, and type into them, and use back, forward, reload, and an address field. Requires an up-to-date iTerm2 Buddy.
  • While you type an @-mention in an AI chat that can control other sessions, you can click the session you mean instead of picking it from the list.
  • it2 session set-status has a new --progress option that starts or stops the tab’s progress indicator.
  • it2 session add-clipping and archive-clippings accept --tmux and --tmux-pane.

Other Improvements:

  • SSH Integration now paces output from the remote host, so a program that prints a lot no longer fills the connection’s buffers. Control-C takes effect at once instead of after minutes of buffered output on a slow link, and typing stays responsive while output streams.
  • Downloading a file or folder with “Download using SSH Integration” is much faster.
  • On a host reached through SSH Integration, it2 is now a real command in ~/.iterm2/bin rather than a shell function, so scripts, sh -c, and tools such as Claude Code’s Bash tool can run it, not just an interactive shell. Commands that read standard input now receive it. A command run with “it2ssh host command”, or by an SSH profile, can use it2 too.
  • On a host reached through SSH Integration, an it2 command that names no session now acts on the session it runs in rather than the focused one.
  • it2 now works on a host reached through SSH Integration when the shell is tcsh, and when shell integration is not loaded there.
  • it2ssh now loads shell integration on the remote host by default, whatever the current profile’s Load Shell Integration Automatically setting. Run it2ssh --no-shell-integration to skip it. SSH profiles still follow their own setting.
  • The git status bar component now shows the status of a repository on a host reached through SSH Integration, by running git there. It used to need it2git set up on the host. With it2git, changes are now counted the same way as for a repository on this Mac.
  • Shell integration now loads inside tmux, including on a host you ssh to from a tmux pane, so marks, the current directory and host, and the git status work there.
  • In a tmux Integration session on a host reached through SSH Integration, each pane now knows which program is running in it, and the git status bar component and other features that depend on the session’s host work without shell integration loaded in the pane.
  • The Claude Code hook program is now it2 handle-agent-hook, so the hook works wherever it2 does. Existing installs keep working; reinstalling the integration updates the hook entries.
  • If you customized the Code Review system prompt, iTerm2 offers to update it the next time a review starts, so reviews work in tmux and on remote hosts. It shows the changes first, and changes nothing else in your prompt.
  • Shell > ssh > Download Files… now lets you choose any file. Before, it only allowed file types that the AI provider accepts as attachments.
  • The notification for a failed download or upload now names the file and gives the reason. Canceling a transfer no longer reports it as failed.
  • Answering No to “Allow Terminal-Initiated Download?” (for example, for it2dl) no longer fills the terminal with the file’s encoded contents. The same goes for declining to display a file inline.
  • When a session’s program ends and iTerm2 offers to restart it, short output such as a custom command’s is no longer hidden behind the offer.
  • Announcements in narrow panes put their buttons below the text when there is no room beside it.
  • When you change the theme, an open browser tab now switches pages that have light and dark versions to the matching one.
  • The browser’s View Source command now shows the page’s source, with attribute values highlighted. Before, it always said “No source available.”
  • In Low Power Mode, status bar graphs such as CPU Utilization move once a second instead of animating continuously.
  • More of the interface is translated, including Window > Lock Location, the tab menu’s Rename Tab… and “Tab Color:”, the browser’s error page, the Downloads and Uploads menus, and file sizes and units throughout. Translated labels no longer get cut off in the shell integration installer, Advanced Paste, Smart Selection, Settings > Keys > Hotkey, the manual AI model editor, and elsewhere.

Bug Fixes:

  • Fixed various crashes, including ones when searching in the AI Chats window, importing a script archive with a damaged signing certificate, finishing an SSH Integration download on a user@host connection, using a trigger in a Dynamic Profile whose parameter has an unexpected type, and when a display reports a refresh rate of 0.
  • Fixed a hang that could freeze iTerm2 with a beachball when GPU rendering was on and the system was under heavy load. Issue 13139.
  • Fixed a bug where a trigger whose interpolated parameter refers to its match, as in (matches[0]), could make output stall, and with tmux integration could freeze every tmux window.
  • Programs that turn on the Kitty keyboard protocol and then request xterm’s modifyOtherKeys, as Claude Code does, keep the Kitty protocol. Before, Command keys stopped being reported. Issue 13138.
  • When an app enables the Kitty keyboard protocol and “Use the Caps Lock key to switch to and from the last used Latin input source” is on, tapping Caps Lock no longer sends a malformed key report that some apps read as Control-C. Issue 13136.
  • With the kitty keyboard protocol reporting all keys, a dead key followed by a key it does not combine with now reports the dead key and then the second key, instead of the second key twice.
  • Installing Shell Integration with “Download and Run Installer” installed outdated scripts, so the warning that they are out of date kept coming back. Issue 13155.
  • Fixed Shell Integration for xonsh, which was installed but never took effect. Installing it again fixes an existing installation.
  • Fixed many problems with the Internet-Free shell integration install: it could hang when the shell you’re using isn’t your login shell or while installing the utilities, could leave bash without the line that loads shell integration, could report success when the utilities failed to unpack, and could leave you inside its helper shells after you canceled.
  • Shell > SSH > Disconnect now recovers an SSH Integration session whose local it2ssh process was killed, and works before advanced SSH features have started.
  • Fixed several ways an SSH Integration session could stop taking input or type stray text such as YXV0b3BvbGw= or cmVjb3Zlcg== into the local shell: when ending a session, after using tmux integration in it, when it2ssh ran on a nested host without the Python advanced SSH features need, and when restoring sessions after relaunching or after a crash.
  • An SSH Integration session restored after relaunching iTerm2 no longer hangs when its connection drops while the remote command is printing output.
  • it2ssh no longer leaves the terminal waiting for Return when ssh fails before connecting, and now exits with ssh’s exit status.
  • it2ssh no longer hangs when the host or command contains non-ASCII text, and now runs a command given after the host exactly as ssh does. Quotes, newlines, tabs and non-ASCII text in the command were mangled.
  • A custom command or SSH profile command that contains a backslash or a double quote now runs as written.
  • When SSH Integration loads shell integration into a remote bash, the shell is now a login shell, so aliases and functions defined in ~/.profile or ~/.bash_profile are available.
  • When you connect with it2ssh user@host or an ssh:// URL, SSH Integration no longer treats all of “user@host” as the host name.
  • Fixed SSH Integration bugs: remote files with non-ASCII names could not be downloaded, deleted, or renamed; deleting a remote symbolic link to a folder failed; a failed remote request could never finish; asking for an immediate update of the remote job list ended the integration; output printed just before a remote command exited could be lost; the remote PATH could be misread; and Composer suggested no remote file names when the host had Python 3.7 or 3.8.
  • On a FreeBSD or OpenBSD host reached through SSH Integration, sessions and the Jobs tool showed an environment variable such as VENDOR=unknown instead of the running program.
  • A file fetched with Shell > ssh > Download Files… no longer stays listed as downloading after it finishes, Clear All now removes finished SSH Integration downloads, and their notification no longer says “Upload finished”.
  • A failed or stopped SSH Integration download no longer leaves a hidden partial file in your Downloads folder or reports success. Stop takes effect right away even when the connection has stalled, and a folder download tells you when files in it couldn’t be read.
  • With the Browser Plugin installed, “Download using SSH Integration” in the context menu no longer does nothing when the file can’t be found.
  • An upload over SSH Integration no longer overwrites a remote file of the same name when iTerm2 could not check whether one exists.
  • Running tmux -CC in a session that is already part of tmux integration now explains that tmux integration can’t be nested instead of silently doing nothing.
  • Fixed saving a window arrangement to a file and archiving a session when the text contained right-to-left text. If either kind of save fails, iTerm2 now reports an error. Issue 13143.
  • With the Minimal or Compact theme and the Snippets tool enabled in the toolbelt, a window could be made wider but not narrower. Issue 13118.
  • With ligatures turned off, some fonts could still draw “fi” as a ligature and leave a gap after it. Issue 13133.
  • Turning off “Show activity indicator” in Settings > Appearance > Tabs now also hides the tab’s spinner when a program reports progress. Issue 13145.
  • Unpinning a pinned tab that was not the rightmost pinned tab, or one in a tab group, no longer breaks the tab bar. Issue 13154.
  • Fixed Kitty graphics images cropped to part of their height showing the wrong part of the image when GPU rendering is on, and Kitty placeholder images showing nothing or the wrong part of a cropped image. Issue 13146.
  • Pressing an arrow key or Tab while composing text with an input method now finishes the character and performs the key in one press, as Return already did. Issue 13030.
  • Hardened the handler for x-man-page: URLs so a malicious URL can no longer run an unexpected command or make man render an arbitrary local file. …
View original

Upgraded? How did it go?

Discussion