cmuxcmux
/docs
Changelog

#cmux 0.64.0: Session Restore on Quit, Passkeys, File Explorer, Task Manager

Session Restore on Quit. Closing the last window with the red X no longer drops your work. cmux restores prior panes on relaunch and resumes Claude Code, Codex, OpenCode, Gemini, and Rovo Dev sessions where you left off.

Passkeys, WebAuthn, and FIDO2. Sign in to passkey-protected sites directly inside cmux browser panes. Reworked inside-out signing keeps the notarized Developer ID build compatible with macOS authentication services.

File Explorer. A Finder-like file explorer sidebar with full SSH support so remote workspaces get the same tree view as local ones.

Task Manager. A built-in Task Manager window plus cmux top CLI shows a live snapshot of windows, workspaces, panes, surfaces, and browser webviews, with jumps from the manager into the matching surface.

Added
  • Restore prior panes and resume Claude Code, Codex, OpenCode, Gemini, and Rovo Dev sessions across relaunch, including when you close the last window with the red X (#2936, #2978, #3259, #3419, #3429, #3487, #3528, #3530, #3535)
  • Passkey, WebAuthn, and FIDO2 support in browser panes (#2660, #2727, #2905, #2908)
  • Task Manager window and cmux top CLI for window, workspace, pane, surface, and browser webview snapshots (#3290, #3471)
  • Finder-like file explorer sidebar with SSH support (#1963)
  • File preview panels in the sidebar (#3139)
  • Menu bar only mode (#3181)
  • System-wide hotkey to show and hide cmux windows (#2389)
  • Cursor and Gemini CLI agent integrations with setup-hooks (#2717)
  • iMessage mode for agent prompts (#3252)
  • Settings sidebar shell and unified config utility window with cmux, Ghostty, and synced tabs (#3024, #3244, #3400)
  • Make cmux.json the canonical settings file with JSONC parsing and legacy settings.json fallback (#3409, #3424)
  • Configurable cmux.json workspace and tab bar plus-button actions (#3084, #3348)
  • Configurable surface tab bar font size (#2645)
  • Configurable workspace recoloring actions, default-bound to Ctrl+Option+0 through Ctrl+Option+9 (#3327)
  • Allow space as a bindable key, allow keyboard shortcuts to be unbound, and make reload and rename shortcuts context-aware (#3333, #3334, #3468)
  • Inline recorder messages explaining shortcut rejections and offering localized Reassign for conflicts (#3035)
  • Help menu with cmux docs nav, Skills, Agent Integrations submenu, and skills.sh install flow (#3402)
  • Find in directory shortcut (#3208)
  • Move tabs into new workspaces (#3285)
  • Hover tooltips on workspace and pane tabs (#3329)
  • Command palette ID copy actions and copy ID context menu actions (#3183, #3247)
  • Command palette actions for right sidebar modes (#3408)
  • macOS clear glass background blur support (#3313)
  • Focus-neutral split-off layout command (#3484)
  • --layout parameter on workspace.create for programmatic split layouts (#2916) -- thanks @talldan!
  • Korean (ko) localization (#2885) -- thanks @say8425!
  • Opt-in setting to open Cmd-clicked Markdown files in the cmux Markdown viewer (#2904) -- thanks @SeongJaeSong!
  • cmux browser disable switch (#3256)
  • Markdown and plain-text variants for docs pages plus /llms.txt index for agent consumption (#3410)
Changed
  • Coalesce sidebar PR polling per-repo, drop checks fetch, and state-machine the probe queue to avoid GitHub rate limits (#2585, #2662)
  • Speed up large terminal pastes by skipping eager HTML/RTF decoding when plain text is available (#3000)
  • Use workspace color for selected sidebar rows and the left rail (#3038, #3082, #3310)
  • Improve default light and dark theme fallback (#3123)
  • Sidebar PR clickability defaults to on, with visibility split from clickability as a separate setting (#3273, #3492)
  • Make hook notifications non-blocking (#3218)
  • Clean up Claude session titles, render slash-command markup as readable titles, and skip meta caveats (#3211)
  • Apply sidebar background to right panel and consolidate sidebar settings (#3103, #3400)
  • Improve settings search aliases with localized variants (#3294, #3296)
  • Disable right sidebar horizontal scroll (#3202)
  • Optimize surface config reload (#3480)
  • Auto-hide terminal scroll bar with disable setting on TUI alt-screen (#2678, #2729)
  • Show Codex TUI errors in the sidebar (#3212)
  • Keep Cmd-Shift-N windows on the source display (#3214)
  • Select find text on repeated Cmd+F (#3314)
  • Disable Claude OSC notifications in the cmux wrapper and gate Claude OSC suppression on integration setting (#3418, #3474)
  • Namespace agent hook CLI commands (#3298)
Fixed
  • Fix shell integration not injected when Ghostty ZDOTDIR overrides the wrapper (#2778) -- thanks @michaeljauk!
  • Allow symlinked Ghostty config files (#2813) -- thanks @ivanrvpereira!
  • Fix paste only pasting first character (#2847) -- thanks @dezren39!
  • Prefer UTF-8 plain text in the pasteboard to avoid Mac OS Roman character loss (#2877) -- thanks @dasanworld!
  • Fix blank split panes after portal reveal (#2840) -- thanks @jaynora2026!
  • Fix workspace color picker context menu blinking (#2566)
  • Hide stale startup workspace portals during teardown (#2658)
  • Fix AX window polling stalls with app hierarchy caching (#2986)
  • Fix close confirmation bypass when spamming close (#2989)
  • Fix multi-workspace close confirmation modality (#3153)
  • Fix Cmd/Ctrl shortcut hint parity (#2994)
  • Cancel drag on Escape (#3013)
  • Pin regular-weight Japanese auto-fallback face (#3015)
  • Fix 100% CPU from ContentView publisher feedback loop (#3028)
  • Fix DebugEventLog NSFileHandle ObjC exception crash (#3034)
  • Fix main-thread blocking in workspace PR refresh (#3036)
  • Fix terminal blanking after OSC completion notifications (#3048)
  • Fix blank terminal after workspace selection (#3012)
  • Fix minimal-mode traffic-light inset, new-window Bonsplit tab bar, window routing, portal hit testing, drag pass-through, and pane tab rendering (#3055, #3150, #3194, #3399)
  • Drop stale merged PRs from the sidebar badge selection (#3063)
  • Fix transparent titlebar backdrop matching and sidebar tint backdrop ownership (#3179, #3382)
  • Fix feedback editor scrolling (#3182)
  • Fix bare window.open(_blank) routing in browser panes (#3262)
  • Fix non-ASCII Cmd+V paste when rich clipboard payloads are lossy (#3268)
  • Fix locale separators in sidebar identifiers (#3269)
  • Deduplicate numpad input across IME full-to-half-width transition (#3292)
  • Follow up equalize splits shortcut fixes (#3309)
  • Make find escape behavior consistent (#3330)
  • Fix unbound Cmd+Shift forwarding to terminal (#3332)
  • Make Ctrl+P command palette navigation remappable and Cmd+D new-tab shortcut rebindable (#3335, #3338, #3398)
  • Prevent shortcut recorder keys from navigating Settings (#3377)
  • Preserve context-separated shortcuts through recorder swaps (#3489)
  • Fix browser tab drag to new workspace, drops into sidebar workspaces, and terminal portal tab drop routing (#3299, #3381, #3430)
  • Fix Cmd+Shift+Enter pane zoom for browser panes (#3520)
  • Fix terminal focus after browser split (#3460)
  • Fix shortcut settings dispatch_once launch crash and settings-file launch crash paths (#3455, #3476)
  • Fix editable shortcuts from settings.json (#3462)
  • Fix live theme picker application, launch theme before app appearance exists, and cmux theme picker Enter from search (#3221, #3378, #3431, #3479)
  • Clamp Settings window away from display edge (#3436)
  • Fix SSH LocalCommand incompatibility with Fish shell (#3506, #3534)
  • Fix OMX HUD bottom pane placement (#3516)
  • Fix inherited Claude auth env in cmux terminals (#3519)
  • Fix config window to open active cmux Ghostty config (#3525)
  • Fix notification dismissal with stale app focus (#3532)
  • Persist app icon mode on the app bundle (#2884)
  • Fix appIcon=automatic crash on macOS Tahoe (#2833)
  • Fix terminal selection autoscroll past viewport edge (#2725)
  • Fix command-hold shortcut hints and prevent sidebar truncation (#2767)
  • Fix Raycast paste fallback regression (#2768)
  • Fix Cmd+Shift+V paste in browser pane (#2779)
  • Fix up/down arrow keys in browser surface (#2780)
  • Fix Cmd+click file path punctuation trimming (#2831)
  • Fix bilibili search popup opening detached window (#2836)
  • Fix macOS modifier desync causing idle terminal input corruption (#2855)
  • Fix scrollback-limit byte handling (#2927)
  • Fix LinkedIn external-link redirect handoff in browser pane (#2930)
  • Fix OpenCode bracketed paste fallback in terminal (#2971)
  • Fix startup hang from repeated file drop overlay install (#2972)
  • Fix cmux.json named workspace colors (#3149)
  • Keep selected workspace visible in the sidebar (#3152)
  • Hide portals for unmounted workspaces (#3155)
  • Fix Bonsplit tab bar height and selected tab separator (#3331, #3351)
  • Fix browser omnibar typing lag with many workspaces (#3422)
  • Fix nightly codesigning for nested bundles, Sparkle executables, and dock tile plugin (#2676, #2677, #2679, #2680)