wmux – 面向 AI 代理的 ADE（代理开发环境）

简介

wmux 是一款桌面应用程序（Windows / macOS），可让您在类似 tmux 的窗格布局中并排运行多个基于 CLI 的 AI 代理工具（Claude Code、Codex、Gemini 等）。后台守护进程即使您关闭 UI 或重新启动也能保持每个窗格的活动状态，并且 iPhone 应用允许您从手机回答代理的交互式提示。

核心概念

概念	wmux 的实现方式
运行任何基于 CLI 的 AI 代理	每个代理都在自己的 PTY（Windows 上为 ConPTY，macOS 上为 forkpty）中运行。Windows 上无需 WSL。
会话持久化	守护进程拥有 PTY。关闭 UI 或崩溃后进程仍会继续运行；重新启动时窗格可以恢复确切的对话。
基于手机的批准	iPhone 客户端与守护进程配对（通过 Tailscale 的 HTTPS）。当代理提问（例如 Claude Code 权限）时，提示会出现在手机的收件箱中；您的回答会被发送回窗格。
扇出到 Git worktree	一个提示可以拆分成最多八个独立的任务。每个任务在 `wtask/*` 分支上拥有自己的 Git worktree、自己的窗格，并且您可以在作为单个提交应用之前逐块审查差异。
内置浏览器自动化	代理可以通过 Chrome DevTools 协议控制内置浏览器窗格或真实的 Chrome 实例。录制的流程可以回放。
Fleet 视图	全局关注列表（`⌘⇧A` / `Ctrl+Shift+A`）显示所有工作区中的代理，并按需要您、待审查、正在运行和空闲分组。
Git 集成	侧栏显示议题/PR，允许您打开、评论、重新运行 CI，并将项目拖到窗格上交给代理处理。

主要功能（快速概览）

跨平台：原生 Windows 10/11 和 macOS Apple Silicon 构建（实验性 Linux AppImage/.deb/.rpm）。
iPhone 伴侣 – 回答问题、查看收件箱、可选推送通知（密封信封）。
Worktree 扇出 – 为并行任务自动创建 Git worktree，并提供可视化差异审查 UI。
浏览器窗格 – 内置基于终端的浏览器或每个代理专用的 Chrome 标签页；录制/回放流程。
代理间消息传递 – 窗格可以相互发送消息（send_message）。
使用量限制处理 – 配额用尽时代理暂停；可选的 重置时继续 自动重新启动它们。
守护进程管理的会话 – 在退出、崩溃、重新启动后仍然存在；窗格可以被监督并自动重新启动。
远程只读视图 – wmux web 将实时窗格提供给浏览器（默认仅回环）。
可扩展的 CLI 和 API – 编写 wmux CLI 脚本或通过令牌认证的套接字连接以响应事件。
键盘驱动 UI – tmux 风格的分割、工作区、命令面板、完全可配置的快捷键。

适用人群

开发者：依赖代码生成代理（Claude Code、Codex、Gemini）并需要稳定多窗格工作区的开发者。
团队：需要在重新启动后保持长时间运行的代理会话，并希望从手机批准操作的团队。
研究人员：试验多代理管道，需要将提示扇出到并行 Git worktree 的方式。
高级用户：喜欢终端多路复用器，但也想要内置浏览器自动化和 GitHub 集成的用户。

开始使用

安装 – winget install openwong2kim.wmux（Windows）或下载签名 .dmg（macOS）。
运行 – UI 启动；守护进程在后台开始运行。
添加代理 – 从选择器中挑选 CLI 代理（Claude Code、Codex、Gemini 等），然后窗格打开。
配对 iPhone – 打开远程 → 共享并配对，在 Tailscale 上启用 HTTPS，使用 iOS 应用扫描二维码。
创建任务 – 输入提示，选择扇出（最多 8 个 worktree），然后审查差异并应用。

从源代码构建（供贡献者使用）

git clone https://github.com/openwong2kim/wmux.git
cd wmux
npm install          # Node 18+、Python 3、原生工具链
npm start            # 开发模式
npm run make         # 打包安装程序

项目使用 Electron、xterm.js、node-pty 和 Playwright 进行测试。

许可与安全

MIT 许可 – 可自由使用和修改。
守护进程只运行您安装的代理 CLI；您仍需遵守每个提供商的条款。
手机和守护进程之间的通信经过令牌认证和加密；推送通知是密封的，因此中继无法读取内容。

wmux 是一个专注于编排 AI 代理的真正软件项目，完全属于 AI 代理开发环境领域。

openwong2kim/wmux