umux logo

Terminal workspaces for Linux, Windows & macOS

Group your terminals into named workspaces, split them into as many resizable panels as you need, and get a desktop notification the moment your AI CLI finishes a long-running task.

Latest release License: MIT Total downloads
Download for macOS Download for Windows All releases
umux — workspaces, tabs and resizable panels
umux main window — workspaces, tabs and panels

Workspaces & panels

One workspace per project, tabs inside it, and any tab splits into as many resizable panels as you need — with a minimum size enforced so nothing collapses. Workspaces persist across restarts and can be pinned to stay on top.

Agent status indicators in umux panels

Agent status & notifications

umux reads the standard OSC completion signals emitted by AI CLIs (Claude Code, Codex, Gemini CLI, Aider…) and fires a native desktop notification when a long-running task finishes. Each panel shows a live agent status — working, needs-attention, idle — detected from escape sequences and process names, never from your terminal content.

Restored umux session with workspaces and panels

Session restore

Close the app, come back tomorrow: your workspaces, tabs and panel layouts are restored exactly as you left them.

Import from cmux

Moving over from cmux? One command — umux import cmux — or the in-app wizard carries your workspaces, groups, working directories and tabs across. Nothing is overwritten: colliding names get a from cmux suffix, and cmux's own files stay read-only.

Import from herdr

Coming soon

On the roadmap: the same one-step import for herdr — workspaces, layout and agent sessions carried over, so switching costs you nothing.

Embedded terminal

Coming soon

In the works: a true terminal surface — colors, cursor movement, alternate screen — so vim, htop and fzf render exactly right, opening your own shell ($SHELL; PowerShell on Windows).

Install the CLI

Prefer the terminal? This drops the umux command-line tool into ~/.local/bin — it reads and writes the same store as the desktop app.

sh
curl -fsSL https://raw.githubusercontent.com/CrystalPlatforms/umux/main/install.sh | sh

Look before you leap: append -- --dry-run to preview what it would do. The CLI manages umux's saved store — it can't control a running app live yet; that's on the roadmap for a future version. macOS and Linux (x86_64). The desktop installers already carry the CLI too — details in the README.

First run — unsigned builds

umux is free & open source and ships without a paid code-signing certificate, so your system may ask for confirmation once:

Full installation instructions →

Ready to run your terminals in umux?

Free & open source — no accounts, no telemetry, no cookies.

Download umux Star on GitHub