wtf is vmux?

vmux is a terminal multiplexer for Linux built specifically for working alongside AI coding agents like Claude Code and similar tools. Panes run inside a background daemon, so if an SSH connection drops or a terminal window closes, the agents keep running and are still there when you reconnect. Agents talk to vmux through a socket, letting them split panes, open new workspaces, read what is on a neighboring pane's screen, and report their own status. That status shows up in a sidebar as busy, needs input, done, or failed, so a person watching several agents at once can tell at a glance which one is waiting on them. Sessions are organized into workspaces, each tied to a project directory and git branch, and each workspace holds tabs that hold individual panes. Installation is a prebuilt binary for Linux and macOS, or building from source with Rust. Windows is not supported because vmux relies on Unix specific features, though it works fine inside WSL. Beyond an install script that checks for updates once a day, vmux makes no other network calls of its own. A built in helper called hooks install wires up integration for agents such as Claude, Codex, and Grok Build automatically, so their status appears in the sidebar without extra configuration. An optional phone relay feature lets someone drive a session remotely over a private network called Tailscale, and it never listens on a public network interface. The project also solves a specific annoyance: pasting a screenshot into an agent running over SSH normally fails because the clipboard lives on the wrong machine, so vmux offers both a small web page and a command line tool to move an image from a local machine into a remote pane. vmux is written in Rust using the ratatui terminal interface library, avoiding heavier frameworks like Electron. It is released under the MIT license.