Muxflow

面向编码 Agent 的远程优先 tmux IDE,把远端会话、文件、Git 与手机通知连成一体。

Star 数
★ 75
最近更新
今天
License
MIT
主语言
TypeScript

30 秒速览

运行形态
桌面应用命令行工具
可在哪里用
兼容但需适配Codex · Claude Code
费用
免费,无需付费服务
上手难度
中 · 需要几步配置
开始前需要
tmux 3.3+Rust 1.97.1(源码构建)Node.js 24(源码构建)pnpm 11(源码构建)Tauri 2 平台前置依赖(源码构建)Shell / 命令行网络访问本地文件系统
典型场景
长时间在远程 Linux 服务器上跑 Claude Code 或 Codex,希望换电脑或断线后会话与进程仍然保留的开发者。
不适合
  • 不常用 tmux、希望零终端配置的用户
  • 需要在 Windows 或 iOS 上使用的团队(文档仅支持 macOS、Linux、Android,iOS 尚在计划中)
  • 远程主机无法安装 tmux 3.3+ 或无法使用 OpenSSH 的环境

这个 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 自行接入。

  1. 长时间在远程 Linux 服务器上跑 Claude Code 或 Codex,希望换电脑或断线后会话与进程仍然保留的开发者。
  2. 笔记本上本地工作、把重负载 Agent 放在远端机器,需要用桌面 App 直接浏览远端文件、看 Git diff 并提交的人。
  3. 离开工位后想用手机接收 Agent 完成通知、打开终端看一眼输出并回一句话的工程师。
  4. 需要同时管理多台主机(开发机、GPU 机、跳板机)并把它们的会话并排对照的团队。
  5. 把截图发给远端 Agent 时受够了 scp 再手输路径,想要直接粘贴图片进面板的用户。
  6. 想用语音在通勤路上给 Agent 下指令、并听取语音回复的个人开发者。

如何安装或部署这个 Agent?

先确保本机以及所有要连接的主机上都安装了 tmux。桌面端通过官方安装脚本安装:

curl -fsSL https://github.com/gal064/muxflow/releases/latest/download/install.sh | bash

Android 端从 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?

  1. 在远端机器上安装 tmux 3.3 或更新版本,并确认终端里可以直接执行 ssh <host>(支持 ~/.ssh/config 中的别名)。
  2. 打开 Muxflow,点击左下角主机名,选择 Connection settings…,再点 + Add host。
  3. 选择 SSH,在 SSH host 中填入主机名或配置别名。
  4. 点 Check helper,再点 Install helper…,把 helper 安装到远端的 ~/.local/bin(无需 root)。
  5. 点 Connect 建立连接。
  6. 如需 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?

FollowAgents 源码审查 · FARS-2.1
缺口较多
53/ 100 五分制 2.7 / 5
信任安全 14/29
可靠稳定 8/14
适用触发 10/18
规范维护 10/18
有效结果 7/13
证据核验 4/8
查看各维度的扣分理由
信任安全14 / 29 · 2.4/5

证据显示:helper 仅监听私有 Unix socket(非 TCP),临时目录与状态目录为 0700,支持包为 0600 且拒绝覆盖与符号链接,明确不复制私钥/密码,认证交由 OpenSSH;无遥测,仅每日一次 GitHub 更新检查。扣分点:安装方式为 curl | bash 直接执行远程脚本,无校验和或签名验证;对 ~/.codex/config.toml 与 tmux 全局环境变量的修改属于对用户环境的持久外部副作用,虽有注释标记与卸载路径,但用户确认流程在文档中未充分展开;依赖安全仅见 Cargo.toml 版本约束,无审计或锁定证据;发布者身份未经验证,归属信息薄弱。

可靠稳定8 / 14 · 2.9/5

证据显示:CI 覆盖 Linux 与 macOS 的 clippy、cargo test、前端检查与 fuzz smoke,故障排查文档对 doctor 状态码、通知权限、Codex unknown 等给出具体诊断路径,错误信息分类明确。扣分点:依赖可用性方面要求 tmux 3.3+、Rust 1.97.1、Node 24、pnpm 11 等较新且严格的版本,未提供降级或兼容说明;未执行任何测试,无法确认自洽性在实际运行中成立。

适用触发10 / 18 · 2.8/5

证据显示:明确面向远程 SSH + tmux 的编码代理场景,支持多主机、桌面与 Android、语音与截图粘贴,能力边界(仅 Codex/Claude Code/pi 有生命周期适配器,其他 CLI 仅作普通窗口)写得清楚。扣分点:触发精度方面,代理状态依赖 hook 与对 Codex 环境变量的 hack,文档自承依赖上游当前行为且可能失效;iOS 标注 coming soon,环境适配存在未完成面。

规范维护10 / 18 · 2.8/5

证据显示:README 结构清晰,含安装、远程连接步骤、故障排查、构建说明与文档索引;LICENSE 为完整 MIT 文本;已知限制(Intel Mac 不支持作主机、macOS 未公证、通知权限陷阱)记录详尽。扣分点:无 CHANGELOG 或版本发布说明文件;命名稳定性方面存在 ADE_ 前缀环境变量与 muxflow 混用,暗示历史改名;维护责任仅指向个人账号 gal064,发布者未经验证,更新路径依赖 GitHub releases。

有效结果7 / 13 · 2.7/5

证据显示:产品输出(终端、文件、Git、端口、通知)对目标用户可直接使用,相对裸 tmux + SSH 提供通知、移动端与粘贴等边际价值。扣分点:成本收益方面需要安装 helper、修改 Codex 配置、维护多端同版本,且 macOS 需绕过 Gatekeeper,部署与维护成本不低;未执行验证实际可用性。

证据核验4 / 8 · 2.5/5

证据显示:文档对隐私与诊断字段做了明确的事实性陈述,区分了已知上游问题(引用 openai/codex issue 编号)与自身实现,事实与推断有一定分离。扣分点:多数功能声明仅有 GIF 与文字,缺少可核对的测试输出或证据文件;跨源佐证有限,CI 配置与文档描述基本一致但未提供运行结果;发布者与来源归属无法独立核实。

风险与缓解建议
  • 安装脚本通过 curl | bash 直接执行远程内容,未提供校验和或签名验证,建议下载后人工审阅再执行。
  • 连接主机时会修改 tmux 全局环境变量与 ~/.codex/config.toml,属于对用户环境的持久副作用,请在受控主机上先确认变更内容。
  • macOS 构建为 ad-hoc 签名且未公证,需手动绕过 Gatekeeper,存在供应链与信任风险。
  • 发布者身份未经验证,更新依赖 GitHub releases 的 latest.json,请自行核实发布来源。
  • 本评估为静态源码审阅,未执行任何构建或测试,功能声明未经运行验证。
证据充分度:低 评估于 2026年11月4日 审查版本 f5a3721893b7
查看完整评分方法 →

常见问题

不用 tmux 也能用吗?
不能。Muxflow 的会话模型直接建立在 tmux 之上,本机和每台远端主机都需要 tmux 3.3 或更新版本,否则会出现无法连接 tmux 的问题。
远程连接会不会在服务器上开新端口?
不会。它复用你的 OpenSSH 配置、密钥与 agent,helper 通过 SSH 和私有 Unix socket 通信,没有额外出站的 TCP 端口。
手机上能做什么?
Android 应用可以查看 Agent 列表与状态、阅读终端输出并输入回复、浏览文件、在任意工作区启动新 Agent,以及用按住说话的方式使用语音模式收发消息。
为什么 Codex 状态显示 unknown?
Codex 0.157 及更新版本运行共享后台服务,隐藏了事件来自哪个面板。解决方法是在新面板或标签页中重新启动 Codex;若你自行设置了 CODEX_EXEC_SERVER_URL,Muxflow 不会覆盖它,状态将不可用。
除了 Codex、Claude Code 和 pi,其他 CLI Agent 支持吗?
可以运行,但作为普通 tmux 窗口存在,不进行注意力跟踪;需要状态跟踪时可通过 agent hooks 自行接入。
在 GitHub 查看 ↗ 安装 ↓

对比同类 Agent

用同一套 FARS 评审,横向比较这个 Agent 所属的短名单。

相关 Agents