cmux

cmux is a terminal multiplexer controlled via a Unix socket CLI. All commands follow the pattern:

cmux [--json] <command> [options]

Key Concepts

• Window — top-level container (like a tmux window)
• Workspace — a tab-like grouping within a window
• Pane — a visible rectangle in a workspace (can contain multiple surfaces)
• Surface — a single terminal or browser tab within a pane
• Panel — an overlay panel (e.g., sidebar)

IDs can be UUIDs, short refs (workspace:1/pane:2/surface:3), or numeric indexes.

Environment Variables