amirlehmam/wmux

What is wmux?

wmux is a Windows‑only terminal multiplexer built on Electron and xterm.js that makes it easy to keep track of coding agents – AI‑driven code assistants such as Claude Code, Codex, Gemini, Aider, etc. It shows each agent’s state (waiting, working, done, interrupted) in a sidebar, lets you jump directly to the pane where the agent is running, and even mirrors the agent’s terminal on a phone‑browser console.

Why it matters for AI‑assisted development

Visibility – AI agents often sit in a hidden terminal pane, waiting for a prompt. wmux surfaces that “needs you” signal with coloured dots and a ranked roster, so you never lose track of which assistant is blocked.
Local, no‑cloud – All detection and UI work happen on your machine; wmux never sends code or screen data elsewhere.
Multi‑agent support – Besides Claude Code (which reports its state via hooks), wmux can infer the state of agents that provide no API (Codex, Gemini, Cursor, Copilot, etc.) by matching their on‑screen UI against bundled detection rules.
Phone‑friendly control – A tiny web console (served on 127.0.0.1:9790) lets you answer prompts, view a mirrored terminal, and send typed input from any phone browser, useful when you step away from the desk.

Core features (high‑level overview)

Feature	What it does
Agent roster & navigator	Banner and `Ctrl+Shift+A/B` shortcuts list every agent, sorted by who has been waiting the longest; click or press Enter to jump to its pane.
Screen‑based detection	Parses the pane’s visual output with bundled rules to label agents as blocked, working, idle or silent when they don’t report their state.
File explorer tied to pane cwd	`Ctrl+Shift+X` opens a right‑hand tree rooted at the current pane’s working directory, shows per‑file change counts, and lets you preview or edit files inline.
Phone web console	Shows a sorted list of agents, mirrors a terminal, and lets you answer prompt buttons with a tap. Secure pairing via QR code; optional Tailscale or SSH tunnel for remote access.
Live browser panel	When Claude Code browses the web, its actions appear in a built‑in Chromium panel; links can open in‑app or in the system browser.
Notification center	Visual bell, Windows toast, and task‑bar flash when an agent finishes or needs attention; also supports OSC 9/99/777 and a CLI `wmux notify`.
Theme & color support	Imports 450+ Ghostty/Windows‑Terminal themes; per‑pane colour schemes via CLI.
Editable code view	Non‑markdown files open in a line‑numbered editor beside the terminal; saves are jailed to the pane’s folder and conflict‑aware.
Session persistence	Save and restore full workspace layout (splits, tabs, browsers, cwd) with a single click; auto‑load last session on start.
Scriptable JSON‑RPC API	Named‑pipe server (`\\.\pipe\wmux`) lets external tools create workspaces, split panes, send keystrokes, read terminal output, etc.
GPU‑accelerated rendering	xterm.js with WebGL for smooth high‑speed terminal output.

Who should consider using it?

Developers who rely on multiple AI coding assistants and find themselves juggling hidden terminal windows.
Teams that want a unified view of agent activity without each assistant having its own UI.
Power users on Windows who already use terminal multiplexers (e.g., tmux, Windows Terminal) and want a graphical, AI‑aware overlay.
Anyone who wants to answer agent prompts from a phone while away from the desk.

Getting started

Download the latest Windows zip from the Releases page (e.g., wmux-0.7.10-win-x64.zip).
Extract and run wmux.exe.
Follow the built‑in 7‑step tutorial to create a workspace, split panes, and launch an agent (e.g., Claude Code).
Open Settings → Remote to enable the phone console, scan the QR code, and pair your device.
Use Ctrl+Shift+A to see the agent roster, or click the coloured dots in the sidebar to jump to a waiting agent.

Limitations & future work (as noted in the README)

No push notifications when the web console page is closed.
No installable PWA, file‑attachment support, or remote start/stop of agents from the phone yet.
Detection rules only cover a handful of agents; community contributions are encouraged.
The orchestrator plugin for Claude Code is deprecated – the functionality now lives inside Claude Code itself.

In short: wmux is a Windows‑only, Electron‑based UI layer that gives you visibility and control over multiple AI coding agents, letting you stay aware of which assistant needs your input and even answer from a phone. It’s a niche but powerful tool for developers who run several AI‑driven code helpers in parallel.