wmux 是一款面向 AI 智能体的桌面开发环境（ADE），定位为「让 AI 智能体并排工作，其余一切自动化」。它原生支持 Windows 和 macOS，无需在 Windows 上使用 WSL。
用途
wmux 用于同时运行多个 CLI 编码智能体（如 Claude Code、Codex、Gemini、agy/Antigravity 以及任何其他 CLI 智能体），每个智能体在独立的终端窗格中运行，由本机后台守护进程维持会话。它适合需要并行处理多个编码任务、跨智能体协作、以及远程监控智能体状态的开发者。
主要能力
- 多智能体并排运行：任意 CLI 智能体在真实 PTY 中并排运行，Windows 上无需 WSL。
- 会话持久化：独立守护进程拥有每个终端，关闭应用、崩溃或重启不会终止智能体会话；恢复后的窗格提供 Resume 功能，可重新输入智能体命令并恢复对话。
- iPhone 远程回复：iOS 应用直接与本机守护进程配对，终端输出和用户回复在两者之间传输，无需云服务中转。智能体提问（单选、多选、多问题或「Other」回答）或权限提示会进入 iPhone 的 Inbox，可直接回复。默认安装暂不发送推送通知，需打开应用查看；配置推送后，通知以密封信封形式经过项目中继，中继无法读取内容。
- 一条提示词分发到多个 git worktree：最多可将一条提示词分发为 8 个任务，每个任务在独立的 git worktree 和 wtask/* 分支上运行独立智能体。可逐块审查 diff、勾选要采纳的代码块，并以全有或全无的 git apply 方式采纳；也可关闭任务（仅在干净检查后移除 worktree）或打开拉取请求。
- Git 集成：侧栏显示仓库的 issue 和 pull request，可查看检查项、失败日志、重跑失败任务、阅读 diff、评论、批准或请求更改、squash 合并。可将 issue 或 PR 拖到智能体窗格或侧栏工作区，智能体收到的是带链接的简短引用，而非条目全文。
- Fleet 视图：快捷键（macOS 为 ⌘⇧A，Windows/Linux 为 Ctrl+Shift+A）列出所有工作区中的所有智能体，按「需要你」「待审查」「运行中」「空闲」分组。需要你的行显示智能体的问题，运行中的行显示当前操作（如 Running npm test）。
- 浏览器自动化：智能体通过 wmux 的 MCP 工具驱动浏览器，包括 navigate、click、type、snapshot、screenshot、有状态的 browser_repl 以及用于录制流程的 browser_replay。可在设置中选择内置浏览器窗格或通过 CDP 驱动的独立 Chrome（每个智能体独立标签页，持久配置文件与日常浏览器分离）。
- 智能体间通信：不同窗格中的智能体可通过 wmux 互相发消息（如 Claude Code 用 send_message 请 Codex 审查代码，Codex 回复缺失的测试用例）。
- 用量限制与账户管理：当 Claude Code 或 Codex 达到用量限制时，窗格暂停并显示重置时间，wmux 会暂存该窗格的定时提示和智能体消息。可开启「重置后恢复」让窗格自动继续。支持注册多个 Claude 或 Codex 订阅，并按剩余配额自动切换账户。设置中可查看各提供商的用量窗口。
- 远程访问：wmux web 可将实时窗格提供给任意浏览器，默认只读且仅限回环地址，输入和网络暴露需显式开启。只读模式也会向能访问端口的人显示窗格完整回滚内容，因此不应发布到开放互联网。
使用方式
- Windows：可通过包管理器安装以跳过 SmartScreen 提示；离线可下载 Setup.exe（目前使用 SignPath 测试证书签名，SmartScreen 会显示未知发布者）。
- macOS（Apple Silicon）：下载 .dmg 并将 wmux 拖入 Applications，已 Developer ID 签名并公证；首次启动时 wmux CLI 会自行安装到 PATH。
- iPhone：从 App Store 免费下载 wmux for iOS。在 wmux 中打开 Remote，选择 Share & pair，开启 HTTPS over Tailscale，用应用扫描二维码。
- Linux：发布页面提供实验性的 AppImage / .deb / .rpm 构建。
- Windows x64 和 macOS arm64 会自动更新：每 30 分钟检查一次发布，并在安装前验证已发布的 SHA-256。
- 从源码构建需要 Node 18+ 和 Python 3.x，以及原生工具链：Windows 上需 VS Build Tools（C++ 工作负载），macOS 上需 Xcode Command Line Tools（xcode-select --install）。
适用场景
- 需要同时运行多个编码智能体并统一管理的工作流。
- 希望将一条提示词并行分发到多个 git worktree 并逐块审查结果。
- 需要在离开电脑时通过 iPhone 回复智能体提问或权限请求。
- 需要智能体驱动真实浏览器完成编码之外的任务。
- 需要会话在应用关闭、崩溃或重启后仍然存活。
限制
- macOS 仅支持 Apple Silicon（arm64），目前不提供 Intel 构建。
- Windows 上 Setup.exe 目前使用测试证书签名，SmartScreen 会显示未知发布者；Windows 11 的 Smart App Control 可能直接阻止未签名二进制文件。
- 默认安装暂不发送推送通知。
- wmux web 默认只读且仅限回环地址，不应发布到开放互联网。
- wmux 运行用户自行安装并登录的智能体 CLI，用户需自行遵守所使用 AI 提供商的服务条款。
- 手动使用 Setup.exe 安装或更新前需完全关闭 wmux（右键托盘图标 → Shut down wmux），否则会因无法替换运行中的目录而失败。
- 基于 xterm.js、node-pty、Electron 和 Playwright 构建；并非 tmux 的移植版，tmux 只是灵感来源。
