Skip to content
SahinurDEVPublic

About

Windows-native workspace for terminals and AI coding agents: split panes, real ConPTY shells, and sessions that come back after a reboot.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

Wmux logo

Wmux

A Windows-native developer workspace for terminals and AI coding agents.

Workspaces · recursive split panes · real ConPTY shells · session restore

Download CI License: MIT Platform: Windows 10/11 Built with Tauri 2 Status: early development

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 wmux CLI 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.

Features (today)

  • 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 like Ctrl+C/D/R/W.
  • Search in terminal output, copy/paste (Windows Terminal conventions), clickable links, dark/light/system themes and accent colors.

Default shortcuts

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.

Install

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 SHA256

Requirements: 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.

Publishing a release (maintainers)

  1. Bump the version in apps/desktop/src-tauri/tauri.conf.json, apps/desktop/package.json and Cargo.toml, and update CHANGELOG.md.
  2. 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).

Build from source

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.exe

Smart App Control

Windows 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.

Project layout

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

Roadmap

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.

Contributing

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.

License

MIT

About

Windows-native workspace for terminals and AI coding agents: split panes, real ConPTY shells, and sessions that come back after a reboot.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Contributors

Languages