Getting cmux to hand HTML files back to my real browser

I asked an agent to build me an HTML artifact this morning, hit the link in the terminal, and got the file rendered into a cmux pane next to me instead of opening in Safari where it had landed for the last few weeks. The artifact looked fine, but the in-app preview pane is not what I want for an HTML page I'm about to QA at 1920×1080 with devtools open.

#What changed

The behaviour switched in cmux 0.64.5, released on 13 May 2026. That release includes PR #4041 — "Open supported files in cmux on cmd-click". It added a new setting that defaults to true:

app.openSupportedFilesInCmux

When it's on, cmd-clicking a readable local file (text, code, PDFs, images, audio, video, HTML) opens the cmux preview pane instead of handing the path to whatever macOS has registered as the default opener for that extension.

For most file types that's actually nice. I don't need a fresh Preview.app window for every PNG. For HTML it's the wrong default for me, because the whole reason I open the HTML file is to drive it in a real browser with devtools and ad-blockers and all my session state.

#The fix

There are three ways in:

1. Settings UI → toggle Open Supported Files in cmux off.
2. Command palette → run the disable action.
3. ~/.config/cmux/settings.json → set the key directly.

I went for option 3 because I keep my cmux config in ~/.config/cmux/ alongside the rest of my dotfiles:

{
  "$schema": "https://raw.githubusercontent.com/manaflow-ai/cmux/main/web/data/cmux-settings.schema.json",
  "schemaVersion": 1,

  "app": {
    "openSupportedFilesInCmux": false
  }
}

cmux picks the change up live, no restart needed in my case. If the pane keeps catching files after the edit, give it a relaunch.

#Other file types and HTTPS links

The toggle is global across every file type the new feature covers. There is no per-extension carve-out today, so turning it off also sends your markdown previews and image previews back to the OS default. If you only want to push HTML out and keep the markdown preview, leave it on and just right-click → Open With → your browser when you need to.

HTTPS links are a separate story. Those still respect the Browser → Host Whitelist setting, which is the one I use to keep GitHub PRs and a handful of internal dashboards opening in cmux instead of bouncing to Safari. That's working exactly as I want it to. The only thing PR #4041 touches is local file cmd-clicks.

Daniel Mackay had flagged the changed behaviour before I ran into it. We checked it at the same time: he found the UI toggle and I found the JSON key. Both change the same setting, so use whichever fits how you manage your cmux configuration.