wmux provides a real-time visibility layer for AI agents, specifically Claude Code, on Windows. It acts as a passive observer, enhancing the user's understanding of agent actions without altering their core functionality. This tool is designed for AI developers and power users on Windows seeking deeper insight and control over their AI agent workflows, offering features like live browser mirroring, detailed activity indicators, and a robust orchestration plugin.

How It Works

Built on Electron and xterm.js with WebGL acceleration, wmux offers a native Windows experience. It integrates passively by observing Claude Code sessions via auto-configured hooks in settings.json and a Chrome DevTools Protocol (CDP) proxy on localhost:9222. This proxy allows Claude Code's native browser tools to directly control a dedicated browser panel within wmux, displaying all web interactions in real-time. Shell integration scripts inject hooks into PowerShell, CMD, and Bash to report terminal activity, Git status, and working directories to a dynamic sidebar. Inspired by macOS's cmux, wmux is a from-scratch reimplementation and is wire-compatible with cmux's socket protocol, enabling interoperability with tools built for its API.

Quick Start & Requirements

Download the latest release zip (e.g., wmux-0.7.10-win-x64.zip) from GitHub Releases, extract it, and run wmux.exe. Ensure the zip file is "unblocked" via file properties if Windows SmartScreen raises a warning. No installer or administrator privileges are required. Building from source involves git clone, npm install, npm run build:main, and npm run dev.

Highlighted Details

• wmux-orchestrator Plugin: A bundled Claude Code plugin activated via /wmux:orchestrate that decomposes complex tasks into parallel agents, runs them in dependency-aware waves, and includes an auto-fix reviewer agent.
• Real-time Visibility: Live display of agent actions (browsing, tool use), terminal activity, Git status, open ports, and PR status in a dynamic sidebar with distinct activity indicators (pulsing orange = working, green = done, red = interrupted).
• CDP Browser Control: Seamlessly observe and interact with web pages browsed by Claude Code through its native tools via a CDP proxy. Terminal and markdown links also open in the integrated browser panel.
• Session Persistence: Automatically saves and restores workspace layouts, including splits, working directories, browser URLs, and shell types across restarts.
• Scriptable Interface: Control wmux programmatically via a named pipe server (\\.\pipe\wmux) supporting JSON-RPC, or through a comprehensive CLI tool for workspace management, agent spawning, and browser interaction.
• Clipboard Image Paste: Paste screenshots directly into the terminal (Ctrl+V) for agents to read, similar to pasting on claude.ai.

Maintenance & Community

The project primarily uses GitHub Issues for bug reports and feature requests, and GitHub Discussions for questions and ideas. Active development is indicated by regular releases, though specific contributor or sponsorship details are not prominent.

Licensing & Compatibility

wmux is released under the MIT License, permitting commercial use and integration. It is designed to be wire-compatible with cmux, allowing tools built for cmux's socket API to function with wmux.

Limitations & Caveats

Live process state (e.g., active Claude Code, tmux, or vim sessions) is not restored upon restart; shells are respawned. Release artifacts are currently not Authenticode-signed, pending SignPath OSS approval, which may trigger security warnings; the updater can be disabled or its quarantine period adjusted via environment variables (WMUX_DISABLE_UPDATER, WMUX_MIN_RELEASE_AGE_DAYS).