About this project

phux is a terminal multiplexer designed for terminals shared by people, applications, and agents. Shells run in a background server, and the TUI, Cockpit, browser, scripts, and agents can all attach to the same live terminal. Unlike tmux, phux exposes Terminal and AgentSession resources over a public wire protocol so visual and headless clients remain peers. Agent state can be emitted as structured lifecycle records, with terminal detection as a compatibility path. Remote access does not require a phux account: `phux --remote me@mini` pairs over SSH once, then attaches directly over QUIC. The project provides a JSON CLI, SDK, and MCP adapter, plus a native macOS Cockpit. Installers support macOS arm64, Linux x86_64, and Linux arm64; Windows is not supported. The default prefix is Ctrl-A, with Ctrl-A d to detach. Documentation covers quickstart, configuration, remote access, agent control, harness emit contracts, and building custom clients. The project is licensed under Apache-2.0.