Skip to content
amirlehmamPublic

About

The original Windows terminal multiplexer for AI agents.

Resources

Stars

448 stars

Watchers

8 watching

Forks

Latest commit

 

History

1,249 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

wmux

Six agents. Which one needs you?
A Windows terminal for running several coding agents at once.

Latest release Downloads Windows x64 MIT license

Download for Windows · wmux.org · Install · Shortcuts · Docs

wmux-film.mp4

The one-minute wmux film. Terminal output is staged for the demo.


Run Claude Code in one pane, Codex in the next, your tests below them and the dev server in a browser on the right. The sidebar tells you which agents are working and which one is waiting for you, and one shortcut takes you there.

wmux runs the command-line tools you already have, with the accounts you already pay for. It sells no agent and adds no account.

Install

Download the latest Windows x64 release:

Format How to use it
Installer Download wmux-<version>-setup.exe and run it.
Portable ZIP Download wmux-<version>-win-x64.zip, extract it, and run wmux.exe.
Scoop Run the commands below.
scoop bucket add wmux https://github.com/amirlehmam/wmux
scoop install wmux/wmux

Installer and ZIP installs update through Settings → Help → Check for updates; Scoop installs use scoop update wmux. Settings and saved sessions live in %APPDATA%\wmux, including for the ZIP.

Releases are not signed with a publicly trusted certificate yet, so Windows may show a SmartScreen warning. Only download wmux from this repository's releases.

Update controls

Set WMUX_DISABLE_UPDATER=1 to disable the updater. For unattended installer downloads, WMUX_MIN_RELEASE_AGE_DAYS sets the minimum release age (3 days by default). A manual update check bypasses that delay. Installing an update still requires confirmation.

Your first five minutes

  1. Open wmux and pick a shell: PowerShell, Command Prompt, Git Bash or WSL.
  2. Open your project with Ctrl+O and start your agent as usual.
  3. Split right with Ctrl+D or down with Ctrl+Shift+D. Put tests, a dev server or a second agent beside the first.
  4. Press Ctrl+Shift+A for the agent navigator, or Ctrl+Shift+B to jump to the agent waiting for you.

On first launch you choose which agent integrations to turn on, and you can change them later in Settings → General. wmux asks before it installs a hook or writes any configuration outside its own folder.

What it does

Every agent, one window

Split panes in any direction, drag tabs between them and zoom the one you are reading. Group the terminals of a project into a workspace, and save the layout to reuse it. Each pane keeps its own shell, folder and colours. wmux ships dark and light appearances, bundled terminal themes and an importer for Windows Terminal and Ghostty settings.

For a setup the whole team shares, commit a wmux.workspace.json. It opens the panes, folders, commands and browser tabs your project needs:

wmux workspace open

See who needs you

The sidebar gathers agent activity, working folders, Git branches and listening ports. The agent navigator lists blocked agents first, and a notification brings you back when an agent finishes or asks something.

Activity comes from agent integrations and, for supported tools, from reading the screen. How much wmux can report depends on the agent: a recognized agent does not always expose a reliable working or waiting state.

A browser beside the code

Open a local dev server or the docs in the browser panel with Ctrl+Shift+I. Agents drive it from the CLI: navigate, read the page, click elements and take screenshots, while you watch it happen. Links open in wmux or in your system browser, as set in Settings → Browser.

Review without leaving the terminal

Open the file explorer with Ctrl+Shift+X or the Git view with Ctrl+Alt+G. Browse working changes, compare a branch against its base and read the commit graph. The Git view stays on the repository you opened while you move between agent panes.

The file viewer handles quick edits, and Markdown panes render plans and docs with diagrams and math. Git worktree workspaces give parallel tasks their own checkout when they touch the same repository.

Script it from any pane

Every terminal wmux opens has the wmux CLI on its PATH, so you, your scripts and your agents can open workspaces, read a pane, drive the browser or send a notification. See CLI below.

Pick up where you left off

wmux restores workspace layouts, tabs and working folders. Shells start again; running processes do not survive a restart.

Agent conversation restore has its own opt-in switches in Settings → Workspace. See the notes for Codex and omp.

Keeping terminal output across restarts is also opt-in, under Settings → Terminal → Scrollback. That output is stored locally as unencrypted text and can contain anything printed in the terminal. Named sessions never archive it.

Check in from your phone

The optional Remote Console shows agent activity and mirrors terminal panes in a phone browser. Send text, use the key bar, or answer a choice an agent is waiting on.

Turn it on in Settings → Remote, reach it through Tailscale or an SSH tunnel, then pair your phone. It is off by default and listens on loopback only. The settings page has the connection steps and lets you revoke a device.

Bring your own agents

Integrated. wmux installs hooks, plugins or instructions so the sidebar knows each agent's state, and asks first.

Agent What wmux adds
Claude Code Hooks for state and notifications, session resume, hooks inside running WSL distros
Codex Opt-in conversation restore through a launcher, without hooks
OpenCode A plugin and an AGENTS.md block, plus session resume (details)
Qwen Code Hooks, instructions and session resume
Kiro A wmux steering file in your Kiro folder
pi An extension, scoped instructions and session resume
omp (Oh My Pi) An extension, an AGENTS.md block and session resume
Grok Build Hooks and a rules file, only when the grok CLI is installed
Antigravity CLI A plugin and conversation resume for agy

Recognized. wmux labels the pane as an agent from its command line and installs nothing: Gemini CLI, Cursor Agent, Copilot CLI, Cline, Aider, Amp, Droid, Goose and Crush.

Any other command-line tool runs in a pane as usual.

Keyboard shortcuts

Action Default shortcut
Open a project folder Ctrl+O
New workspace Ctrl+N
New tab Ctrl+T
Split right / down Ctrl+D / Ctrl+Shift+D
Move focus between panes Ctrl+Alt+Arrow
Zoom the current pane Ctrl+Shift+Enter
Agent navigator Ctrl+Shift+A
Jump to a waiting agent Ctrl+Shift+B
File explorer Ctrl+Shift+X
Project Git view Ctrl+Alt+G
Browser panel Ctrl+Shift+I
Markdown pane Ctrl+Shift+M
Command palette Ctrl+Shift+P
Settings Ctrl+,
Shortcut reference Ctrl+F1

Rebind any of them in Settings → Keyboard, where the workspace and tab number-row shortcuts can also be changed or turned off.

CLI

wmux is available inside the terminals it opens and talks to the running app over a named pipe.

wmux ping
wmux new-workspace --title "Frontend" --panes 2 --layout columns
wmux list-workspaces
wmux tree

# Inspect agent activity and terminal output
wmux agent-state
wmux read-screen --lines 50

# Open a plan or a local preview
wmux markdown docs/plan.md
wmux browser open http://localhost:3000
wmux browser snapshot

# Notify yourself when a script finishes
wmux notify "Tests finished"

# Open an SSH workspace
wmux ssh user@host --title "Remote"

Run wmux help for the command list, or wmux <command> --help for usage. Commands that target a terminal accept a surface ID where documented, so a script can address one specific tab.

For containers and remote machines, see the devcontainer guide. Paste and drop can upload files into direct SSH panes; configuration and limitations explain when that applies.

Documentation

Guide What it covers
Configuration ~/.wmux/config.toml, themes, key remaps and file uploads
Workspace manifests Project layouts, startup commands and dependencies
WSL file explorer Directory reporting and files across Windows and WSL
Devcontainers Connecting container shells to the desktop app
OpenCode integration Plugin behavior, compatibility and troubleshooting
Codex session restore Resuming the right conversation in each tab
ChatGPT Web dictation Account setup, microphones and dictating into a terminal
omp session restore Transcript tracking and restore behavior
Crash reports Collecting a useful report without sending a memory dump

Looking for a recent change? Read the release notes.

Build and contribute

wmux is built with Electron, React, TypeScript, Zustand, xterm.js and node-pty/ConPTY.

On Windows, with Git and a current Node.js LTS:

git clone https://github.com/amirlehmam/wmux.git
cd wmux
npm ci
npm run build:main
npm run dev

Clone into a short path without spaces, such as C:\dev\wmux, to avoid native build and packaging issues.

npm test
npm run typecheck
npm run lint
npm run build:renderer

The main process lives in src/main, the UI in src/renderer and the CLI in src/cli. AGENTS.md describes the module boundaries and conventions. Release builds run in GitHub Actions when a version tag is pushed.

Open an issue for a bug or a feature request, or start a discussion. For a bug, include the wmux version, the shell, the steps to reproduce and what you expected. For a crash, start with wmux crash-report, and never attach a memory dump: it can contain credentials.

Credits and license

wmux is an independent Windows implementation inspired by cmux, and reuses none of its code. The agent visibility model was also influenced by herdr.

Licensed under MIT.

About

The original Windows terminal multiplexer for AI agents.

Resources

Stars

448 stars

Watchers

8 watching

Forks

Releases

Packages

Contributors

Languages