A Windows-native developer workspace for terminals and AI coding agents.
Workspaces · recursive split panes · real ConPTY shells · session restore
Website · Download · Docs · Features · Install · Build from source · Roadmap · Architecture · Contributing
Status: early development (v0.3). Terminals, workspaces, splits, drag and drop, session restore across restarts and agent status are implemented. AI agents, the embedded browser, Git, port monitoring and the
wmuxCLI are on the roadmap.
Wmux is an independent open-source project inspired by the workflow of tools like cmux. It shares no code, branding or assets with them.
- Real terminals. Every terminal is a Windows Pseudo Console (ConPTY) session rendered with xterm.js (WebGL). PowerShell 7, Windows PowerShell, cmd, WSL distributions, Git Bash and custom shells are detected automatically.
- Process-tree safety. Each shell runs in a Job Object, so closing a tab, killing a terminal or a Wmux crash never leaves orphaned processes.
- Workspaces. Create, rename, duplicate, pin, color and reorder (drag and drop). Each workspace has its own directory, shell, startup commands and environment.
- Split panes. Nested horizontal/vertical splits, resizable, maximize/ restore, directional focus, and terminal tabs in every pane.
- Agents at a glance. Claude Code, Codex, Gemini CLI, OpenCode and Aider are recognized when they run in a terminal. The tab, the workspace in the sidebar and the status bar show whether the agent is working, waiting for you, or idle.
- Drag and drop. Drag a tab onto another pane, onto a side of a pane to split it off, or onto a workspace in the sidebar. The terminal keeps running.
- Session restore that survives a reboot. Workspaces, layouts, tabs and working directories come back, and so does each terminal's text. A Claude Code or Codex conversation that was open is resumed with the agent's own resume command, and a command that was still running (a dev server, a watcher) is started again. Processes themselves cannot survive a restart: Wmux starts a new shell and picks up where the old one stopped. Each part can be turned off in Settings → Terminal.
- Keyboard-first. Command palette (
Ctrl+Shift+P) with fuzzy search and customizable shortcuts that never steal shell keys likeCtrl+C/D/R/W. - Search in terminal output, copy/paste (Windows Terminal conventions), clickable links, dark/light/system themes and accent colors.
| Action | Shortcut |
|---|---|
| Command palette | Ctrl+Shift+P |
| New workspace / open folder | Ctrl+Shift+N / Ctrl+Shift+O |
| Close workspace | Ctrl+Shift+W |
| Next / previous workspace | Ctrl+Tab / Ctrl+Shift+Tab |
| Switch to workspace 1-9 | Ctrl+1 ... Ctrl+9 |
| New terminal tab / close tab | Ctrl+Shift+T / Ctrl+Shift+Q |
| Split right / split down | Ctrl+Shift+D / Ctrl+Shift+E |
| Maximize pane | Ctrl+Shift+Enter |
| Focus pane in a direction | Ctrl+Alt+Arrow |
| Swap pane with its neighbor | Ctrl+Alt+Shift+Arrow |
| Search terminal output | Ctrl+Shift+F |
| Restart terminal / clear | Ctrl+Shift+R / Ctrl+Shift+K |
| Toggle sidebar | Ctrl+Shift+B |
| Settings | Ctrl+, |
Ctrl+C copies when text is selected (otherwise it interrupts), Ctrl+V pastes,
and right-click copies the selection or pastes.
The original design suggested Ctrl+D for "split right". That is EOF in bash,
WSL, Python and many REPLs, so Wmux uses Ctrl+Shift+D. Every shortcut can be
changed under Settings > Keyboard.
Download the latest release and pick one:
| File | Use it if |
|---|---|
Wmux_<version>_x64-setup.exe |
Recommended. Per-user installer, no admin rights needed. |
Wmux_<version>_x64_en-US.msi |
You deploy software with MSI / Group Policy. |
Wmux-portable-x64.zip |
You want no installation; unzip and run Wmux.exe. |
Every release includes SHA256SUMS.txt. Verify a download with:
Get-FileHash .\Wmux_0.3.0_x64-setup.exe -Algorithm SHA256Requirements: Windows 10 (1809+) or Windows 11, x64, and the Microsoft Edge
WebView2 runtime. It is built into Windows 11; the installer downloads it on
Windows 10 if it is missing. The portable ZIP stores data in
%APPDATA%\dev.wmux.desktop unless WMUX_DATA_DIR is set.
Unsigned builds: Wmux is not code-signed yet, so SmartScreen may show "Windows protected your PC". Choose More info → Run anyway. Windows 11 Smart App Control blocks unsigned apps entirely; code signing is on the roadmap.
Development builds from every commit are available as artifacts on the CI workflow runs.
- Bump the version in
apps/desktop/src-tauri/tauri.conf.json,apps/desktop/package.jsonandCargo.toml, and updateCHANGELOG.md. git tag vX.Y.Z && git push origin vX.Y.Z
The release workflow runs the tests, builds
the installers, and publishes them with a portable ZIP and checksums. It also
publishes latest.json and a signature for the installer; installed copies
read these to update themselves.
Updates are signed with a key pair made by pnpm tauri signer generate. The
public key is in tauri.conf.json (plugins.updater.pubkey); the private key
is the repository secret TAURI_SIGNING_PRIVATE_KEY. Keep a copy of the
private key somewhere safe: installed copies only accept updates signed with
it, so if it is lost they can never be updated in place again. Local and CI
builds skip signing with --config src-tauri/tauri.unsigned.conf.json
(pnpm build does this).
Prerequisites: Rust (stable, MSVC toolchain), Node.js 22+, pnpm 9, and Visual Studio Build Tools with the "Desktop development with C++" workload.
pnpm install
pnpm dev # run the app with hot reload
pnpm build # NSIS + MSI installers in target/release/bundle
pnpm test # frontend unit tests + all Rust tests
pnpm test:e2e # end-to-end test against target/release/wmux-desktop.exeWindows 11 Smart App Control blocks unsigned executables without
reputation, which includes every binary you compile locally (Cargo build
scripts, tests and the app itself). If a build fails with "An Application
Control policy has blocked this file (os error 4551)", either turn Smart App
Control off (Windows Security > App & browser control) or build in CI. The
GitHub Actions workflow in this repository builds, tests and packages Wmux on
windows-latest.
apps/desktop/ React + TypeScript UI, Tauri 2 shell in src-tauri/
crates/conpty/ Safe ConPTY wrapper with Job Object process-tree control
crates/process-manager/ Terminal session threads, I/O and lifecycle
crates/session-manager/ SQLite schema, migrations, snapshots, backups
tests/e2e/ Playwright-over-CDP end-to-end test of the real app
docs/ Architecture, decisions and progress
site/ Website (landing page and docs), published to GitHub Pages
| Phase | Scope | Status |
|---|---|---|
| 1-3 | Foundation, ConPTY terminals, workspaces, splits, persistence | In progress |
| 4 | AI agent adapters (Claude Code, Codex, Gemini CLI, OpenCode, Aider) | Planned |
| 5 | Embedded WebView2 browser and browser automation API | Planned |
| 6 | Git panel, port monitoring, workspace search | Planned |
| 7 | wmux CLI and named-pipe automation API |
Planned |
| 8-10 | Notifications, crash recovery, signing, ARM64 (in-app updates shipped in 0.4.0) | Planned |
Details and per-item verification status: docs/PROGRESS.md.
Contributions are welcome! Please read CONTRIBUTING.md and docs/ARCHITECTURE.md first, and follow our Code of Conduct. Report security issues privately as described in SECURITY.md.