cmux SSH
cmux ssh user@remote creates a workspace for the remote machine. Drag an image into a remote Claude Code session and it gets uploaded automatically. Browser panes route through the remote network, so localhost just works. Uses your ~/.ssh/config, reconnects on drops.
A remote development workflow
- Connect with cmux ssh and let cmux create a dedicated workspace for the remote host.
- Open a browser pane next to the terminal and use localhost URLs as if the dev server were local.
- Run Claude Code, Codex, OpenCode, or another agent on the remote machine and let cmux route notifications back to your Mac.
- Drag files or images into the remote terminal when the agent needs local context or test fixtures.
- Browser panes route through the remote machine, so
localhost:3000reaches the remote dev server without port forwarding - Drag an image into a remote terminal to upload via scp
- Coding agents on the remote box send notifications to your local sidebar
cmux claude-teamsandcmux omowork over SSH, spawning teammate panes locally while computation runs remote- The sidebar shows connection state and detected listening ports
FAQ
Do I still need ssh -L for localhost?
Usually no. Browser panes inside the remote workspace route HTTP and WebSocket traffic through the remote machine, so local preview URLs resolve from the remote host.
Does it use my existing SSH config?
Yes. cmux reads ~/.ssh/config for aliases, identity files, proxy settings, and host options, then adds cmux-specific routing and reconnect behavior.