cmuxcmux
/docs
Changelog

#cmux 0.64.16: AI Auto-Naming, Per-Workspace Env Vars, Left/Right Option as Alt

AI Auto-Naming for Workspaces and Tabs. Opt in to have cmux name your workspaces and tabs from the agent conversation running inside them, so a wall of sessions stays readable at a glance.

Per-Workspace Environment Variables. Set environment variables on a workspace and every shell it spawns inherits them, so per-project configuration no longer has to live in your shell profile.

Left and Right Option as Alt. macos-option-as-alt now distinguishes the left and right Option keys, sending sided modifier bits to the terminal. One of our most-requested terminal fixes.

iOS Beta Polish. A redesigned workspace list with groups, unread dots, and last-activity previews; smoother terminal scrolling; cross-device notification dismiss-sync with an authoritative unread badge; and a TestFlight push-notification fix.

Added
  • Opt-in AI auto-naming of workspaces and tabs from your agent conversations (#5547) -- thanks @mvanhorn!
  • Per-workspace environment variables inherited by every shell in the workspace (#6116)
  • Configurable file explorer double-click action: preview, default editor, or preferred editor (#5827)
  • Setting to hide modifier shortcut hints (#6071)
  • Configurable Dock max width (#4385) -- thanks @sort2f for the report!
  • Customizable stable window title templates (#6059) -- thanks @digijoebz for the report!
  • Diff language highlighting aliases (#6076)
  • Expose each workspace's custom title to the control socket for scripting (#6013)
  • iOS (beta): workspace list with groups, unread dots, last-activity previews, and a shared Unread filter (#5726)
  • iOS (beta): workspace row actions (#6022) -- thanks @azooz2003-bit!
  • iOS (beta): Shift key on the terminal keyboard toolbar (#6104)
  • Experimental freeform 2D canvas layout for workspace panes, still in progress (#5987) -- thanks @azooz2003-bit!
Changed
  • macos-option-as-alt now honors left and right Option independently, sending sided modifier bits to the terminal (#6007) -- thanks @1nto5, @ucan-lab, @MrSpock, @Sancerro, @dreasan, @alceal, @lejahmie, and @tofunori for the reports!
  • Gate remote SSH port scanning on the sidebar ports setting (#6136) -- thanks @Fail-Safe for the report!
  • Polish the experimental canvas minimap navigation (#6105) -- thanks @azooz2003-bit!
  • Make Codex agent hooks fire-and-forget so they never block the session (#6110)
  • Detect live claude/codex processes so hook-less agent sessions stay fork-able (#6133)
  • Stagger restored terminal surface spawns to smooth session restore (#6149)
  • Reclaim offscreen terminal renderer GPU memory (IOSurface) non-destructively (#5857)
  • iOS (beta): smoother terminal scrolling with local scrollback prefetch and faster scroll rendering (#6067, #6035) -- thanks @azooz2003-bit!
  • iOS (beta): cross-device notification dismiss-sync and an authoritative unread badge (#5916)
  • iOS (beta): local-first, offline-safe sign-out (#5776)
  • iOS (beta): require a matching email for pairing (#6028)
Fixed
  • Fix terminal top-row mouse event routing, including minimal-UI hit testing (#4391, #6073) -- thanks @colangelo and @edouardp for the reports!
  • Restore OSC 11 pane-local backgrounds (#5997) -- thanks @fkchang for the report!
  • Fix the macOS 27 SF Symbol rasterization crash (#5999) -- thanks @matheustimbo and @joseluislucio for the reports!
  • Fix a stale Metal drawable after terminal layer realization (#6057) -- thanks @robertnisipeanu for the report!
  • Fix terminal arrow key routing for TUI model selection (#6002) -- thanks @wo4wangle for the report!
  • Fix the Cmd+T working directory after session restore (#6055) -- thanks @WangRouna for the report!
  • Preserve Pi sessions across workspace restore (#5607) -- thanks @bjesuiter for the report!
  • Fix top-right titlebar drag chrome (#6003) -- thanks @dbachelder for the report!
  • Fix the OpenWrt BusyBox remote platform probe (#6056) -- thanks @Fail-Safe for the report!
  • Fix stale remote connected state after a proxy disconnect (#4513)
  • Surface a browser fallback when Safari sign-in hangs (#6113)
  • Fix the browser omnibar Return submitting stale text during fast typing (#5923)
  • Avoid mirroring web proxies as CONNECT (#5959)
  • Fall back to SSH when the Cloud VM attach endpoint is unavailable (#6079)
  • Fix sidebar row-height layout feedback (#6111)
  • Kill a sidebar LazyVStack layout livelock (#6033) -- thanks @azooz2003-bit!
  • Fix unexpected menu-bar-only activation policy (#6068)
  • Fix Mermaid diagrams scaling in the markdown viewer zoom (#6072)
  • Honor Focus / Do Not Disturb for the fallback notification sound (#5651) -- thanks @Reebz!
  • iOS (beta): fix compact workspace row navigation by removing redundant tap gestures (#6124) -- thanks @azooz2003-bit!
  • iOS (beta): reduce workspace row swipe contention (#6064) -- thanks @azooz2003-bit!
  • iOS (beta): fix a workspace swipe-delete confirmation crash (#6051) -- thanks @azooz2003-bit!
  • iOS (beta): preserve the email code sign-in nonce (#6097)
  • iOS (beta): fix TestFlight push notifications by exporting the production APNs entitlement (#6131)