WebMux is a terminal that keeps running in the browser, built for driving CLI agents such as Claude Code and Codex from anywhere. Sessions live on the server; browsers, phones and local terminals just attach.
curl -fsSL https://github.com/mzdluo123/webmux/releases/latest/download/install.sh | shv0.10.2 · Linux, macOS, Windows (WSL 2) · MIT
01 / Start at your desk
Close the laptop; the agent keeps working. The overview groups every session by repository and shows live who is running, who is waiting for you, and what is on each screen.
02 / Take over on your phone
A lock-screen notification brings you back. Answer in the native TUI with the soft-key bar, or switch the same conversation to the chat view. One reply and it carries on.
03 / Review back at your computer
Review it and keep going in the same terminal; send path:line to the agent in one click. It is the same process all the way, and not a line of output is lost.
A single binary of about 24 MB that keeps terminal sessions on the server.
Every image is a real screenshot from the WebMux repository.
Hybrid sessions
OpenCode, omp, Codex CLI and Claude Code switch between the terminal and a chat view with the full history kept; the chat side handles attachments, permission prompts and token usage. The chat side of Codex CLI and Claude Code needs a third-party ACP connector (codex-acp, claude-agent-acp), which is not an official component of WebMux or the agent vendors.
Plus Shell and omp. Icons only indicate compatibility; trademarks belong to their owners.
1. Install. Detects Linux / macOS and amd64 / arm64, verifies SHA-256 and installs to ~/.local/bin. No sudo, no changes to your shell config.
curl -fsSL https://github.com/mzdluo123/webmux/releases/latest/download/install.sh | shThe mirror is a third-party service and can see your IP. The binary and SHA256SUMS must come from the same source and pass verification.
2. Run. Then open http://127.0.0.1:7681 in a browser and click “New session”.
webmux --listen 127.0.0.1:76813. Next: keep it running in the background, reach it from your phone, start agents from your usual terminal.
1. Prepare WSL 2. Windows 10 22H2+ or Windows 11, WSL 2 from the Microsoft Store (run wsl --update in PowerShell), and at least one distribution. No administrator rights needed.
2. Download and run webmux-setup-windows-amd64.exe . It installs for the current user only. The installer is unsigned; if SmartScreen blocks it, choose “More info → Run anyway”.
3. In the tray menu, choose “Install webmux in WSL”. The tray fetches the Linux binary matching your distribution, verifies its SHA-256, installs it, and starts WebMux from the menu.
Debian / Ubuntu. On arm64, pick the matching package from the download table.
curl -LO https://github.com/mzdluo123/webmux/releases/download/v0.10.2/webmux_0.10.2-1_amd64.deb
sudo apt install ./webmux_0.10.2-1_amd64.debFedora / RHEL / openSUSE. On arm64, pick the matching package from the download table.
curl -LO https://github.com/mzdluo123/webmux/releases/download/v0.10.2/webmux-0.10.2-1.x86_64.rpm
sudo dnf install ./webmux-0.10.2-1.x86_64.rpmStart at login. Packages never enable the service for any user. The first start writes ~/.config/webmux/config.toml with a random token.
systemctl --user enable --now webmuxWithout the script, download the binary and SHA256SUMS, verify, then install (Linux amd64 shown):
curl -LO https://github.com/mzdluo123/webmux/releases/latest/download/webmux-linux-amd64
curl -LO https://github.com/mzdluo123/webmux/releases/latest/download/SHA256SUMS
sha256sum --check --ignore-missing SHA256SUMS # macOS: shasum -a 256 -c --ignore-missing SHA256SUMS
install -m 755 webmux-linux-amd64 ~/.local/bin/webmuxFor other platforms use webmux-{linux,darwin}-{amd64,arm64}. Install and upgrade docs
WebMux exposes a shell to the network as your user, listening on 0.0.0.0:7681 by default. For local use, listen on 127.0.0.1; for remote access, bind to a trusted VPN such as Tailscale or WireGuard. Do not expose it to the internet unless you deliberately use a tunnel and accept that the token is the only barrier. It is not a process sandbox, and restarting the service ends every terminal session. Read the security model
| Dimension | WebMux | SSH + tmux | ttyd / gotty | mosh |
|---|---|---|---|---|
| Session survives client disconnect | YesServer holds the PTY; a service restart ends sessions | Yestmux sessions keep running after detach | Not verifiedPair with tmux yourself; ttyd's --once exits on disconnect | PartialOfficially survives roaming and laptop sleep |
| Mobile TUI support (soft keys, touch scroll) | YesSoft-key bar, touch scrolling, locked terminal size | PartialDepends on the phone's SSH client | Not verifiedNot stated in official docs | Not verifiedNot stated in official docs |
| Agent question / permission alerts on lock screen | YesDepends on the CLI's status signals; push needs HTTPS | Not verifiedNot stated in official docs | Not verifiedNot stated in official docs | Not verifiedNot stated in official docs |
| Switch between chat view and TUI | PartialClaude Code, Codex CLI, OpenCode, omp | NoTerminal only | NoTerminal only | NoTerminal only |
| Single binary, no root or database | Yes~15 MB static binary, no tmux needed | PartialNeeds sshd and tmux; tmux needs no root | YesSingle executable | PartialNo privileged code or daemon; needs SSH and UDP ports |
Third-party cells checked against official docs on 2026-11-03; “Not verified” means the docs do not say.See the full comparison
bash -ic 'exec opencode "$@"' opencode to pick up the PATH and environment from ~/.bashrc, or add the program's directory to the service PATH. See agent PATH (Chinese).[tailscale] mode = "serve" and open https://<node>.ts.net/ on the phone. Alternatively, listen on the server's Tailscale / WireGuard address and enter the token once. Your firewall should only allow the trusted VPN interface to reach the port. An HTTPS address can also be installed as an app and receive lock-screen notifications. See phone access (Chinese).127.0.0.1:7681 for local use, bind to a trusted VPN such as Tailscale or WireGuard for remote use, and use a random token (the first start generates a 256-bit one). Do not expose it directly to the internet; if you must, use a controlled tunnel only, and accept that the token is then the only barrier. See security and deployment.webmux.exe can run / attach WSL sessions from PowerShell or Windows Terminal. See Windows (WSL) deployment (Chinese).Copy the command to install it, or read the source on GitHub first.
curl -fsSL https://github.com/mzdluo123/webmux/releases/latest/download/install.sh | sh