Summary
When I navigate the cmux browser pane to a file:// URL (e.g. by clicking a link in a terminal pane, or pasting into the address bar), cmux strips the file:// scheme and prepends https:// instead. The browser then tries to resolve the path's first segment as a hostname, which fails.
Repro
- In a terminal pane, output a
file:// URL such as file:///Users/me/some-file.html (e.g. an Open it at file:///… message from a tool).
- Click the URL, or copy it and paste into the browser pane's address bar.
Expected
Browser loads the local file at /Users/me/some-file.html.
Actual
Address bar shows https://Users/me/some-file.html (or, in my case, https://raw/pipeline/observability-diagrams/exec-summary.html — the leading /Users/admin/berkshire-vault/ was also stripped along with the scheme).
Page shows: "Can't reach this page — https://… refused to connect. Check that a server is running on this address."
Why this matters
Local HTML previews are a common workflow — agents generate static HTML reports/dashboards into the workspace and the natural next step is to open them in the cmux browser pane. With this bug, the only workaround is to open them in an external browser, which loses the in-cmux workflow.
Environment
- cmux desktop app (recent build, May 2026)
- macOS (Darwin 24.1.0)
Summary
When I navigate the cmux browser pane to a
file://URL (e.g. by clicking a link in a terminal pane, or pasting into the address bar), cmux strips thefile://scheme and prependshttps://instead. The browser then tries to resolve the path's first segment as a hostname, which fails.Repro
file://URL such asfile:///Users/me/some-file.html(e.g. anOpen it at file:///…message from a tool).Expected
Browser loads the local file at
/Users/me/some-file.html.Actual
Address bar shows
https://Users/me/some-file.html(or, in my case,https://raw/pipeline/observability-diagrams/exec-summary.html— the leading/Users/admin/berkshire-vault/was also stripped along with the scheme).Page shows: "Can't reach this page —
https://…refused to connect. Check that a server is running on this address."Why this matters
Local HTML previews are a common workflow — agents generate static HTML reports/dashboards into the workspace and the natural next step is to open them in the cmux browser pane. With this bug, the only workaround is to open them in an external browser, which loses the in-cmux workflow.
Environment