3.7.5macOS
Version 3.7.5
Added 20
- Floating Panes: a pane that floats over a tab's split panes, creatable via Shell > New Floating Pane with Current Profile or a key binding or pointer action
- Floating panes can be dragged by their title bar, resized by their edges, and docked into split panes or moved to another tab or window by holding Control while dragging
- Window > Floating Panes menu to raise, dock, move, and hide floating panes, which 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)
- Interface localization following the Mac's language, available in Brazilian Portuguese, German, Japanese, Russian, and Simplified Chinese
- Support for the Program Status Protocol (OSC 7501), letting programs report working, waiting, done, or failed status with messages and progress shown on the tab
- Session Status "done" and "error" statuses sorting below "waiting" and above "working", with "idle" now sorting last; pressing a key in the session marks the result as seen and returns it to idle
- Claude Code reports a finished turn as "done" and an API error as "error" in Session Status
- Ollama as an AI provider, listing installed models from the local Ollama server with context window and capability detection, with separate models selectable for chats and quick background tasks
- "Ollama (auto-discover)" and "Ollama (native)" presets, plus a Fetch Models button and Vision checkbox in the manual model editor for servers on other machines
- Session Status tool can follow Codex CLI via hooks in ~/.codex/hooks.json running cc-status with --agent codex, showing Codex status and progress per turn
- Cockpit can send a command to many sessions at once from a docked composer, selecting targets with @ and sending with Shift-Return
- Cockpit shows each session's live status and detail line in every grouping, and a filter bar to narrow the list by status
- "Set Profile Setting" trigger action that turns a profile checkbox on or off for the session
- "Prevent sleep" profile setting that keeps the Mac from idle-sleeping while a session with the setting exists, applying only on AC power
- AI chat can set timers that act after a delay or at a set time, surviving restarts, firing immediately if overdue, and optionally pushing to a phone
- Cmd-F search in AI chat with a find bar, match counts, next/previous navigation, in-place highlighting, and smart-case, case-sensitive, and regular expression modes
- Right-clicking your own AI chat message offers Delete (removing it and everything after), with Edit, Fork, and Delete also available inside the message text
- OSC 1337 SetWindowFrame, ReportWindowFrame, and ReportScreenFrames codes to move and resize windows across monitors using global coordinates
- OSC 1337 SetColors accepts palette index values written i:N (0-255), with indices 0-15 following the loaded color preset and light or dark mode
Changed 4
- The native AI API type formerly named "Llama" is renamed "Ollama", sizes the context window to the prompt so long prompts are not silently truncated, and the chat Think toggle controls whether a reasoning model thinks
- Cmd-Z now undoes text editing in the focused field (composer, browser address bar, annotations, notes, AI chat) and Cmd-Shift-Z redoes
- Undo Close is now solely Shell > Undo Close (Cmd-Shift-T); a one-time notice explains the change the first time Cmd-Z is pressed with a restorable closed session
- Editing or deleting AI chat messages now syncs to a paired iPhone viewing the same chat, and the phone can delete messages too
3 changes to check, marked in the notes below
From iTerm2
Credit to Nimanou (nuved) for the right-to-left rendering, selection, and copy improvements in this release.
Major 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).
- iTerm2 is now localized: the interface follows your Mac’s language and is available in Brazilian Portuguese, German, Japanese, Russian, and Simplified Chinese.
- 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”, above “working”, and “idle” now sorts last. Pressing a key in the session marks the result as seen and turns it idle. Claude Code now reports a finished turn as “done” and an API error as “error”. Customized priority lists get the two new statuses added below “waiting”, notifying if “idle” did.
New Features:
- Ollama is now a first-class AI provider alongside OpenAI, Anthropic, Gemini, and DeepSeek. Choose it in Settings > General > AI and iTerm2 lists the models installed on your local Ollama server, reading each model’s context window and capabilities (thinking, tools, vision) from the server, so there is nothing to configure. You can pick one model for chats and a smaller one for quick background tasks. For a server on another machine, use the new “Ollama (auto-discover)” or “Ollama (native)” presets, or the manual model editor’s new Fetch Models button and Vision checkbox. The native API type, formerly named “Llama”, is now named “Ollama”; it sizes the context window to your prompt so long prompts are no longer silently truncated, and the chat’s Think toggle now controls whether a reasoning model thinks.
- ⌘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. behavior changed · inferred
- The Session Status tool can now follow Codex CLI as well as Claude Code. There is no installer for Codex yet: in ~/.codex/hooks.json, point each hook event at a script that runs the cc-status tool from the utilities folder inside iTerm2.app’s Resources with --agent codex, and set timeout to 3 on the Interrupt and SessionEnd hooks. The tab then shows Codex’s status and a progress indicator through each turn. Codex also reports a finished turn as “done” and an API error as “error”.
- The Cockpit can now send a command to many sessions at once from a composer docked along its bottom. Type @ to pick a session, tab, or window (selecting rows in the list does the same), then type the command and press Shift-Return to send it to every chosen pane. The Cockpit also now shows each session’s live status and detail line in every grouping, and a filter bar along the top narrows the list to one status.
- 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 declarative “while this job runs” logic.
- A new “Prevent sleep” profile setting keeps the Mac from idle-sleeping while a session with the setting enabled exists. Combine it with the new “Set Profile Setting” trigger action to keep the Mac awake only while a long-running job, like an AI coding agent, runs. It applies only while the Mac is on AC power.
- AI chat can now set a timer to act after a delay or at a set time (for example, “in two hours, run this command”). The timer survives restarts, fires immediately if its time already passed, and can push your phone when it fires.
- You can now press Cmd-F in an AI chat to search the current conversation. A find bar appears at the top with match counts and next/previous navigation; matches are highlighted in place. Supports smart-case, case-sensitive, and regular expression modes.
- Right-clicking your own message in AI chat now offers Delete, which removes that message and everything after it. Edit, Fork, and Delete are also available when right-clicking inside the message text. Editing or deleting a message now also syncs to a paired iPhone viewing the same chat (and the phone can delete messages too).
- 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.
- 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 follow the loaded color preset and light or dark mode, so a program can set the badge or tab color to track the preset instead of hardcoding an RGB value. For example, SetColors=badge=i:3 uses ANSI yellow. Issue 12991.
- iTerm2 now answers CSI 16 t (report character cell size), which was previously ignored.
- Each profile can now choose what its bell sounds like, in Settings > Profiles > Terminal > Bell sound. Pick one of the sounds installed on your Mac or choose “Other…” for any audio file of your own, and give noisy sessions a bell you can tell apart from the rest.
- 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.
- Window > Lock Location pins a window to its current display and position. If anything moves the window it goes right back, and if its display is disconnected, as happens while a laptop sleeps, the window returns when the display comes back. Dragging the window turns the lock off.
- The built-in web browser can now remember HTTP basic-auth user names and passwords. Check “Remember this password” in the sign-in dialog and it is saved in the browser password manager (Keychain, 1Password, and the other supported back ends) and offered automatically next time. The dialog also has a Password Manager button to pick an existing login. View or remove saved passwords from the password manager.
- The Compact and Minimal themes, which have no title bar, can now show the window name beside the tabs. It appears once you name a window with Window > Edit Window Title, so windows you haven’t named look the same as before. Double-click the name to rename the window.
- The workgroup toolbar can show an AI Usage gauge with your Claude subscription’s session and weekly usage as progress bars. Add it to a session’s toolbar in the workgroup settings and choose how often it refreshes; it reads the numbers by running the Claude Code command-line tool. You can point it at your own command instead.
- New variables iterm2.workingSessionCount and iterm2.waitingSessionCount count the sessions whose status reads “working” or “waiting”. Use them anywhere interpolated strings work, such as badges, tab titles, and the status bar.
- 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 per-profile setting “Use HDR cursor when available” in Settings > Profiles > Colors. When on, a white cursor renders brighter than white on an HDR-capable display, with either the GPU or the legacy renderer, and a slider sets how bright it gets.
- 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. This keeps full-screen apps that lay out their own text from being scrambled. 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.
- it2 can now target the session showing a particular tmux pane. From inside a tmux Integration pane, pass --tmux "$TMUX" --tmux-pane "$TMUX_PANE" to session set-status, get-status, set-var or get-var. This also works on a host reached through SSH Integration. Claude Code’s status is no longer reported from a pane of a plain tmux session (one not using tmux Integration), since iTerm2 can’t tell which tab, if any, is showing that pane. behavior changed · inferred
- New
it2 session get-statusprints a session’s status indicator as JSON.set-statusno longer requires --session and defaults to the active session. - A session status can now say when it stops being true. With it2 set-status --expires-on, a program gives the status to switch to once the work it describes is over, so a status doesn’t outlive a program that was stopped partway through.
- The it2 command-line tool can now send a push notification to your paired companion device with “it2 notify «title» «body»”.
Improvements:
- A warning that iTerm2 shows while you are away from your Mac no longer cuts 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 (a password manager’s master password, an scp password). 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.
- Pairing a companion iPhone no longer requires AI. The setup wizard (iTerm2 > Companion Device Settings) now lets you choose “Terminal viewing & control only”, so you can browse sessions, watch live output, and type from your phone without an AI plugin or API key. Chat features appear disabled with an explanation until you turn AI on.
- 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 from their archives in their original split panes, tabs, and windows. The last 20 can be undone even after restarting iTerm2.
- iTerm2 now recognizes when a terminal is running on your own Mac by machine identity rather than by hostname, so features that only work locally keep working over a VPN or Tailscale connection where the hostname no longer matches. Reinstall shell integration (iTerm2 > Install Shell Integration) to enable this.
- The AI timeout is now an idle timeout (the maximum gap between bytes received) rather than a cap on the total time a request may take. A slow but healthy generation, such as a reasoning model that is still thinking or a cold local model, keeps running as long as it makes progress, while a dead connection still fails. The default was also raised to 20 minutes. This … behavior changed · inferred