Muxflow
面向编码 Agent 的远程优先 tmux IDE,把远端会话、文件、Git 与手机通知连成一体。
- Star 数
- ★ 75
- 最近更新
- 今天
- License
- MIT
- 主语言
- TypeScript
- FA 评分
- 53/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 兼容但需适配Codex · Claude Code
- 费用
- 免费,无需付费服务
- 上手难度
- 中 · 需要几步配置
- 开始前需要
- 典型场景
- 长时间在远程 Linux 服务器上跑 Claude Code 或 Codex,希望换电脑或断线后会话与进程仍然保留的开发者。
- 不适合
- 不常用 tmux、希望零终端配置的用户
- 需要在 Windows 或 iOS 上使用的团队(文档仅支持 macOS、Linux、Android,iOS 尚在计划中)
- 远程主机无法安装 tmux 3.3+ 或无法使用 OpenSSH 的环境
- 源码审查
- 53/100 · 缺口较多
这个 Agent 能做什么,适合哪些场景?
Muxflow 是一个基于 tmux 的远程优先 IDE,用 Tauri 构建,覆盖 macOS、Linux 桌面端以及 Android 应用。它的核心理念是会话留在主机上:关闭应用、重启笔记本或换机器后,所有窗口、面板和进程依然存在,tmux 会话对应工作区、窗口对应标签页。它通过你现有的 OpenSSH 配置连接 Linux 或 macOS 远程主机,helper 走 SSH 加私有 Unix socket 而非 TCP 端口,多个主机可以并排展示。除终端之外,它还提供 Ports 标签页(查看监听端口并一键转发)、文件浏览与 Markdown 预览、Git 的 diff/stage/commit/push,以及跨 SSH 的原生粘贴——截图上传后路径直接落进远端面板。Codex、Claude Code 和 pi 有生命周期适配器,能在桌面和 Android 上推送「等待回答/已完成」通知,并支持手机端的语音回复与语音模式。
Muxflow 连接本机或 SSH 远端(Linux/macOS)上的 tmux 服务端,把每个 tmux 会话映射为工作区、窗口映射为标签页、面板映射为面板,重命名双向同步。远程连接依靠 OpenSSH 配置、密钥和 agent,并在远端 ~/.local/bin 安装 helper,helper 通过 SSH 与私有 Unix socket 通信,无需 root。Ports 标签页列出主机上的监听端口并支持一键转发到本机;文件面板可浏览、编辑、下载文件并预览 Markdown;Git 面板执行 diff、stage、commit、push。粘贴截图或文件时,Muxflow 通过同一 SSH 连接上传,并把路径写入终端,使 Codex 或 Claude Code 把图像当作本地文件读取。Agent 状态来自可审阅的 agent hooks,桌面端与 Android 端据此在 Agent 阻塞提问或结束时通知,Android 应用还能查看终端输出、输入回复、启动新 Agent、浏览文件,并用按住说话的方式收发语音消息。Agent 生命周期适配器覆盖 Codex、Claude Code 和 pi,其他 CLI Agent 作为普通 tmux 窗口运行,可通过 hooks 自行接入。
- 长时间在远程 Linux 服务器上跑 Claude Code 或 Codex,希望换电脑或断线后会话与进程仍然保留的开发者。
- 笔记本上本地工作、把重负载 Agent 放在远端机器,需要用桌面 App 直接浏览远端文件、看 Git diff 并提交的人。
- 离开工位后想用手机接收 Agent 完成通知、打开终端看一眼输出并回一句话的工程师。
- 需要同时管理多台主机(开发机、GPU 机、跳板机)并把它们的会话并排对照的团队。
- 把截图发给远端 Agent 时受够了 scp 再手输路径,想要直接粘贴图片进面板的用户。
- 想用语音在通勤路上给 Agent 下指令、并听取语音回复的个人开发者。
如何安装或部署这个 Agent?
先确保本机以及所有要连接的主机上都安装了 tmux。桌面端通过官方安装脚本安装:
curl -fsSL https://github.com/gal064/muxflow/releases/latest/download/install.sh | bashAndroid 端从 releases 页面下载并安装 APK。若要从源码构建,需要 Rust 1.97.1、Node.js 24、pnpm 11、tmux 3.3+ 以及 Tauri 2 的平台前置依赖:
pnpm install --frozen-lockfile
pnpm test:transport:local
tmux new-session -s work
pnpm tauri dev打包命令为 pnpm release:linux -- x86_64、pnpm release:macos 和 pnpm mobile:apk:release。
如何使用这个 Agent?
- 在远端机器上安装 tmux 3.3 或更新版本,并确认终端里可以直接执行
ssh <host>(支持~/.ssh/config中的别名)。 - 打开 Muxflow,点击左下角主机名,选择 Connection settings…,再点 + Add host。
- 选择 SSH,在 SSH host 中填入主机名或配置别名。
- 点 Check helper,再点 Install helper…,把 helper 安装到远端的
~/.local/bin(无需 root)。 - 点 Connect 建立连接。
- 如需 Agent 通知,点 Set up agent status… 为 Codex、Claude Code 和 pi 配置 hooks。
遇到通知不出现时,可在 Settings 的 System notifications 下点 Send test notification 自检;连接卡顿时先对目标主机执行 Check helper,必要时 Upgrade helper。
这个 Agent 有哪些优点和局限?
- 会话保存在主机端的 tmux 里,关闭应用、重启笔记本或换机器都不丢窗口、面板和进程。
- 远程连接复用现有 OpenSSH 配置与密钥,helper 走 SSH 加私有 Unix socket 而非暴露 TCP 端口。
- 跨 SSH 原生粘贴:截图或文件直接上传并写入远端面板路径,Codex 与 Claude Code 可将其作为图像读取。
- 集成了 Ports 端口转发、文件浏览与 Markdown 预览、Git diff/stage/commit/push,减少在多个工具间切换。
- Codex、Claude Code、pi 具备生命周期适配器,桌面与 Android 均能收到阻塞提问和完成通知,并支持手机语音回复。
- MIT 许可,Linux x86_64、macOS Apple Silicon 和 Android 都有现成发布产物。
- 强依赖 tmux:本机与每台远端主机都需 tmux 3.3+,不熟悉 tmux 的用户上手成本明显。
- 文档只覆盖 macOS、Linux 与 Android,iOS 标注为 coming soon,Windows 未提及。
- Codex 0.157 及以上使用共享后台服务会隐藏事件来源,导致状态显示为 unknown,需要在新面板中重启 Codex。
- 语音相关能力依赖可选语音模型,需要单独下载,其上游与转换模型卡在第三方声明中另列。
- 远端多出 helper 组件,版本不匹配时需要手动 Check helper / Upgrade helper 排查。
这个 Agent 与同类方案有什么区别?
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| Muxflow 当前 | 53 · 缺口较多 | 桌面应用免费 | ★ 75 | 今天 | TypeScript | Codex · Claude Code |
| Intent 桌面代理工作台 | 60 · 存在缺口 | 桌面应用 | ★ 377 | 今天 | JavaScript | — |
| TermFold Debian 编程终端 | 51 · 缺口较多 | 桌面应用免费 + 模型费 | ★ 32 | 1 个月前 | Kotlin | Codex · Claude Code |
| Synara | 52 · 缺口较多 | 桌面应用免费 + 模型费 | ★ 2.2k | 今天 | TypeScript | Codex · Claude Code |
FollowAgents 如何评估这个 Agent?
查看各维度的扣分理由
证据显示:helper 仅监听私有 Unix socket(非 TCP),临时目录与状态目录为 0700,支持包为 0600 且拒绝覆盖与符号链接,明确不复制私钥/密码,认证交由 OpenSSH;无遥测,仅每日一次 GitHub 更新检查。扣分点:安装方式为 curl | bash 直接执行远程脚本,无校验和或签名验证;对 ~/.codex/config.toml 与 tmux 全局环境变量的修改属于对用户环境的持久外部副作用,虽有注释标记与卸载路径,但用户确认流程在文档中未充分展开;依赖安全仅见 Cargo.toml 版本约束,无审计或锁定证据;发布者身份未经验证,归属信息薄弱。
证据显示:CI 覆盖 Linux 与 macOS 的 clippy、cargo test、前端检查与 fuzz smoke,故障排查文档对 doctor 状态码、通知权限、Codex unknown 等给出具体诊断路径,错误信息分类明确。扣分点:依赖可用性方面要求 tmux 3.3+、Rust 1.97.1、Node 24、pnpm 11 等较新且严格的版本,未提供降级或兼容说明;未执行任何测试,无法确认自洽性在实际运行中成立。
证据显示:明确面向远程 SSH + tmux 的编码代理场景,支持多主机、桌面与 Android、语音与截图粘贴,能力边界(仅 Codex/Claude Code/pi 有生命周期适配器,其他 CLI 仅作普通窗口)写得清楚。扣分点:触发精度方面,代理状态依赖 hook 与对 Codex 环境变量的 hack,文档自承依赖上游当前行为且可能失效;iOS 标注 coming soon,环境适配存在未完成面。
证据显示:README 结构清晰,含安装、远程连接步骤、故障排查、构建说明与文档索引;LICENSE 为完整 MIT 文本;已知限制(Intel Mac 不支持作主机、macOS 未公证、通知权限陷阱)记录详尽。扣分点:无 CHANGELOG 或版本发布说明文件;命名稳定性方面存在 ADE_ 前缀环境变量与 muxflow 混用,暗示历史改名;维护责任仅指向个人账号 gal064,发布者未经验证,更新路径依赖 GitHub releases。
证据显示:产品输出(终端、文件、Git、端口、通知)对目标用户可直接使用,相对裸 tmux + SSH 提供通知、移动端与粘贴等边际价值。扣分点:成本收益方面需要安装 helper、修改 Codex 配置、维护多端同版本,且 macOS 需绕过 Gatekeeper,部署与维护成本不低;未执行验证实际可用性。
证据显示:文档对隐私与诊断字段做了明确的事实性陈述,区分了已知上游问题(引用 openai/codex issue 编号)与自身实现,事实与推断有一定分离。扣分点:多数功能声明仅有 GIF 与文字,缺少可核对的测试输出或证据文件;跨源佐证有限,CI 配置与文档描述基本一致但未提供运行结果;发布者与来源归属无法独立核实。
- 安装脚本通过 curl | bash 直接执行远程内容,未提供校验和或签名验证,建议下载后人工审阅再执行。
- 连接主机时会修改 tmux 全局环境变量与 ~/.codex/config.toml,属于对用户环境的持久副作用,请在受控主机上先确认变更内容。
- macOS 构建为 ad-hoc 签名且未公证,需手动绕过 Gatekeeper,存在供应链与信任风险。
- 发布者身份未经验证,更新依赖 GitHub releases 的 latest.json,请自行核实发布来源。
- 本评估为静态源码审阅,未执行任何构建或测试,功能声明未经运行验证。