amirlehmam/wmux

什么是 wmux？

wmux 是一个基于 Electron 和 xterm.js 的 Windows 专用终端多路复用器，可轻松跟踪 代码代理 —— 如 Claude Code、Codex、Gemini、Aider 等 AI 驱动的代码助手。它在侧边栏中显示每个代理的状态（等待中、工作进行中、已完成、中断），允许你直接跳转到代理运行的面板，并可将代理的终端镜像到手机浏览器控制台。

对 AI 辅助开发的意义

可见性 – AI 代理通常隐藏在终端面板中等待提示。wmux 通过彩色圆点和排序的代理名单，将“需要你”这一信号可视化，让你永远不会错过哪个助手处于阻塞状态。
本地运行，无云依赖 – 所有检测和 UI 操作均在你的机器上完成；wmux 永远不会将代码或屏幕数据发送到外部。
多代理支持 – 除了通过钩子报告状态的 Claude Code 外，wmux 还能通过匹配其屏幕 UI 与内置检测规则，推断出未提供 API 的代理（如 Codex、Gemini、Cursor、Copilot 等）的状态。
手机友好控制 – 通过 127.0.0.1:9790 提供的微型 Web 控制台，你可从任意手机浏览器中回答提示、查看镜像终端，并发送输入，特别适合离开办公桌时使用。

核心功能（概览）

功能	作用
代理名单与导航器	顶部栏和 `Ctrl+Shift+A/B` 快捷键列出所有代理，按等待时间最长者排序；点击或按 Enter 可跳转至其面板。
基于屏幕的检测	使用内置规则解析面板的视觉输出，当代理未报告状态时，可将其标记为阻塞、工作、空闲或静默。
与面板工作目录绑定的文件浏览器	按 `Ctrl+Shift+X` 打开右侧树形结构，根目录为当前面板的工作目录，显示各文件的变更次数，并支持内联预览或编辑文件。
手机 Web 控制台	显示排序后的代理列表，镜像终端，并可通过点击响应提示按钮。通过 QR 码安全配对；支持 Tailscale 或 SSH 隧道用于远程访问。
实时浏览器面板	当 Claude Code 浏览网页时，其操作会显示在内置 Chromium 面板中；链接可于应用内或系统浏览器中打开。
通知中心	代理完成或需要关注时，触发视觉铃声、Windows 通知弹窗和任务栏闪烁；也支持 OSC 9/99/777 和 CLI 命令 `wmux notify`。
主题与颜色支持	支持导入 450+ 个 Ghostty/Windows-Terminal 主题；可通过 CLI 为每个面板设置独立颜色方案。
可编辑代码视图	非 Markdown 文件在终端旁以带行号的编辑器打开；保存操作被限制在面板文件夹内，并具备冲突感知能力。
会话持久化	一键保存和恢复完整工作区布局（分屏、标签页、浏览器、工作目录）；启动时自动加载上一次会话。
可脚本化的 JSON-RPC API	通过命名管道服务器（`\\.\pipe\wmux`）让外部工具创建工作区、分割面板、发送按键、读取终端输出等。
GPU 加速渲染	使用 WebGL 的 xterm.js，实现高速流畅的终端输出。

哪些人应该考虑使用它？

依赖多个 AI 代码助手，却在管理隐藏终端窗口时感到困扰的开发者。
希望在不为每个助手单独配置 UI 的情况下，获得统一代理活动视图的团队。
已使用终端多路复用器（如 tmux、Windows Terminal）的 Windows 高级用户，希望获得一个图形化、AI 友好的叠加层。
希望在离开办公桌时，通过手机回答代理提示的任何人。

快速入门

下载：从发布页面下载最新 Windows zip 包（例如 wmux-0.7.10-win-x64.zip）。
解压并运行 wmux.exe。
按照内置的 7 步教程创建工作区、分割面板，并启动一个代理（例如 Claude Code）。
打开 设置 → 远程，启用手机控制台，扫描 QR 码并配对设备。
使用 Ctrl+Shift+A 查看代理名单，或点击侧边栏的彩色圆点跳转至等待中的代理。

限制与未来工作（README 中注明）

当 Web 控制台页面关闭时，不支持推送通知。
尚不支持可安装的 PWA、文件附件功能，或从手机远程启动/停止代理。
检测规则仅覆盖少数代理；鼓励社区贡献。
Claude Code 用的协调器插件已弃用——该功能现已内置于 Claude Code 本身。

简而言之：wmux 是一个 Windows 专用的 Electron 基础 UI 层，让你能够可视化并控制多个 AI 代码代理，清楚知道哪个助手需要你的输入，甚至能从手机上进行响应。对于在并行运行多个 AI 驱动代码助手的开发者而言，这是一个小众但强大的工具。