第 1 层客户端
桌面应用、平板浏览器或安卓 App。客户端保存主机记录、凭据和决策日志,不运行 Agent。
AgentMux 用来管理运行在远程主机和本机上的 AI 编程 Agent,支持 Claude Code、Codex、Gemini CLI、Grok CLI、Aider 等。每个 Agent 运行在所属主机的 tmux 会话中,关闭客户端、笔记本休眠或网络中断都不会中断任务。平板和手机也可以使用。
AgentMux 不托管 Agent 进程。它连接到主机上的 tmux 会话,Agent 在会话里运行,所以客户端是否在线不影响任务。
桌面应用、平板浏览器或安卓 App。客户端保存主机记录、凭据和决策日志,不运行 Agent。
每台主机只建立一条 SSH 连接,终端、命令和文件传输共用这条连接,打开多个终端只需认证一次。本机不需要 sshd,直接连接。
Agent 在主机的 tmux 会话中运行。关闭客户端、笔记本休眠或网络中断后会话继续运行;重新打开客户端会接回原来的 pane,滚动缓冲保留。
AgentMux 不托管 Agent 进程,而是连接到主机上的 tmux 会话。会话是否存活与客户端无关。
客户端断开、笔记本休眠或网络中断时,Agent 继续运行。重新打开客户端会连回同一个 pane,滚动缓冲完整保留。长时间任务不再依赖一条不断开的 SSH 连接。
每个 Agent 的 pane 都是完整的终端,支持颜色、鼠标、选中和搜索。可以随时介入输入、纠正 Agent,然后交还控制权,不需要重启任务。
终端区最多拆成 3×3 九个窗格,跨主机同屏、各自独立操作。分隔缝可拖动,双击标签临时全屏,窗格布局随窗口宽度智能折行,下次启动自动恢复。
把一条指令发送给选中的多个 Agent,每个 Agent 返回送达回执,批量操作的结果可以逐个核对。
可以让 Ollama 本地模型执行一个目标,例如查明某个 Agent 为什么卡住。编排器一次执行一个工具调用,任何写操作都会暂停等待你审批;定时巡检只允许只读操作。
项目事实、偏好与 Agent 活动被索引,可按原文或语义检索。Embedding 本地生成,内容不出本机;命中已知模式的凭据在入库前自动脱敏。
同一个二进制可以无头运行,平板浏览器打开后就是完整的 AgentMux,包括终端、Agent、工具箱和文件浏览。安卓还有内嵌核心的独立 App,SSH 直接从设备发起,不需要常开的机器。
过去集群树上的 Agent 只有「运行中」一种状态。现在 AgentMux 会定期读取每个 pane 的内容并分类:正在提问、已完成等待查看、或停在提示符。需要人工处理的 Agent 会在树上高亮,查看后标记清除。
启动后和每六小时检查一次新版本:下载、校验 sha256、原地替换并重启,失败时自动回滚。全部配置可以加密导出为一个文件,在另一台电脑导入,导入不会覆盖已有条目。
以下均为应用截图。
附着到任何 Agent 的 tmux pane:全彩输出、鼠标报告、搜索与选中。右侧面板同时给出进程状态、最近输出与操作按钮。

把同一条指令发送给选中的 Agent,可以跨项目、跨主机。每个 Agent 返回送达回执,便于逐个确认。

安装面板先探测主机,只展示它真正能装的 Agent CLI 与运行时,并说明其他项为何不可用。安装在 tmux 内执行,连接中断也不会留下装了一半的包。

默认使用 Apple 系统色板,另有 Nord、Solarized 等六套主题,包含浅色模式。信息密度按长时间值守的需求调整。

除了桌面应用,还有两种使用方式:无头 serve 模式让任意浏览器成为完整客户端;安卓有内嵌核心的独立 App。两者使用同一份前端和同一个核心,功能与桌面版一致。
Release 附带专用服务器版 agentmux-server-linux-{amd64,arm64}——完全静态,不需要 GTK/WebKit,也不需要图形界面,复制到任何 Linux 服务器裸启动即服务。桌面版加 --serve 进入同一模式。首次启动生成访问令牌并打印在日志里(存于数据目录 serve-token,也可用 AGENTMUX_TOKEN 指定)。
平板浏览器访问 http://主机:8642,输入一次令牌——终端、Agent、工具箱、文件浏览全部可用。iPad 上「分享 → 添加到主屏幕」、安卓上「添加到主屏幕」,之后它就是一个独立 App。关闭浏览器不会停掉任何东西——和关掉桌面窗口一样,Agent 都活在远端 tmux 里。
每个 Release 附带 agentmux-android.apk(Android 8.0+ · arm64),内嵌与服务器版同源的完整核心,由前台服务拉起——锁屏也不会被冻结,SSH 直接从设备发起,配置与密钥留在本机。手机与平板的布局也重做过:窄屏下侧栏改为覆盖式抽屉,底部导航栏把集群树、命令面板、详情与设置放到拇指够得到的位置,并尊重安全区。
桌面应用、无头 serve 和安卓 App 使用同一个核心,区别在于核心运行的位置。
| 桌面 App | 无头 serve | 安卓 App | |
|---|---|---|---|
| 核心运行在 | 你的电脑 | 任意一台 Linux 机器 | 设备本身 |
| 需要常开的机器 | 不需要 | 需要(服务端) | 不需要 |
| 使用方式 | 桌面窗口 | 任意浏览器:iPad、安卓平板、手机 | 原生 App,前台服务保活 |
| 状态存放 | 本机 SQLite | 服务端,所有客户端共享同一份 | 设备本地 |
| 鉴权 | 系统钥匙串 | 访问令牌;公网请置于 HTTPS 反代之后 | 设备本地 |
| 下载文件 | agentmux-macos / windows / linux | agentmux-server-linux-{amd64,arm64} | agentmux-android.apk |
除平板与手机支持外,8 月更新还包含以下功能。
终端掉线不等于任务结束——远端 tmux 还在跑。管道会被重建:同一个 shell id、同一份滚动缓冲、同一个 pane,退避从 1 秒到 15 秒,约五分钟后仍保留手动重连按钮。TCP 与 SSH 双 keepalive 各答一个问题;一次性命令终端不会被重跑。
有些活必须看见画面。右键主机,3389 与 5900 经它已有的那条 SSH 连接转发到本机,交给系统自带的查看器(远程桌面连接 / 屏幕共享 / Remmina)。只监听环回的桌面因此无需对外开放任何端口。
启动后与每六小时检查一次发布源,有新版本就在标题栏下方拉起一行横幅:升级重启、看更新说明、或稍后。下载带进度条并校验发布的 sha256,替换失败自动回滚到正在运行的那个版本。
主机、目录、项目、工作区与 Agent 定义写进一个口令加密的文件(Argon2id + AES-256-GCM),在另一台电脑打开。导入永不覆盖:同址主机、同名项目、同机同路径一律保留原样,同一个文件导入两次不会多出任何东西。
指标面板不再只讲主机在干什么,也讲它是什么:CPU 型号、内存条规格、物理磁盘与显卡。这些是静态信息,走一次性读取并按会话缓存,不占三秒一次的轮询。
一键安装新增 Grok CLI、Docker(六种方式,网络需要时自动切镜像,装完顺手起守护进程并加用户组)与 Ollama;界面新增繁體中文——按台湾用语重写的完整词表,不是简繁字符转换。
以下约束是设计决定,不是配置项,大多数无法关闭。
密码与密钥口令以 AES-256-GCM 加密后落盘,密钥保存在系统钥匙串(Keychain / Credential Manager / Secret Service)。钥匙串不可用时降级为 0600 文件并在状态栏明示。
首次连接即固定主机密钥,之后任何不匹配都会中止连接并给出解释——中间人替换无法静默通过。
任何机密都不会跨入 UI 进程——界面只知道「某项机密已设置」,拿不到内容本身。
编排器只能调用固定白名单内的工具,每个工具在声明时就绑定风险等级。执行必须经过唯一的门:风险级 × 主机信任级 × 触发来源共同决定放行与否。
定时巡检被无条件拒绝一切非只读工具,该限制不可配置。它可以报告哪个 Agent 停滞了,但没有权力去动它。
每次编排运行的每一步都被记录——包括被拒绝、被否决、被搁置的提案。远程主机的输出以「数据」标记进入模型上下文,指令形状的文本会在审批卡片上触发警示。
AgentMux 的架构基于以下四条原则。
AgentMux 连接主机上的 tmux 会话,不托管 Agent 进程。客户端退出不影响正在运行的任务。
一个二进制文件加一个 SQLite 数据库。不需要账号、守护进程或后端服务,主机信息只保存在你的电脑上。
编排器只负责调查和提出建议,任何修改主机的操作都需要你确认。无人值守巡检只允许只读操作。
Embedding 在本地计算,机密不会传给界面进程。Agent 直接从主机连接模型服务商,AgentMux 不代理这些流量,也不读取 API Key。
迁移、重构、大规模测试等运行时间超过一个工作日或一次网络连接的任务。
在三到五十台主机上同时运行 Agent,统一显示在一棵树里,包含每个 Agent 的状态和最近输出。
一次操作向多个 Agent 下发指令,并收到每一份送达确认。
通过安装面板把新主机配置到可用状态,不需要手动拼装安装命令。
定时只读巡检,报告停滞的 Agent,不执行任何修改。
规划、embedding 和记忆全部在本地运行;不代理 Agent 的模型流量,不读取 API Key。
类 Unix 远程主机只需要 tmux 和一个 SSH 账号——tmux 缺失时 AgentMux 可以代装;远程 Windows 启用 OpenSSH 即可。 本机更简单:连凭据都不用。
阅读完整文档→远程机:地址、用户,ssh-agent / 密钥 / 密码任选其一,支持跳板机。本机:只要起个名字。
指定主机上的工作目录。也可以直接浏览主机文件,找到目录就地添加——名字、路径、主机都是现成的。
一个名字加一条启动命令。点 Start,它就跑在该主机的 tmux 会话里了。
claude --dangerously-skip-permissions附着 Agent、开 shell、装 CLI、换主题——最快的路径都在这里。
Ctrl / ⌘ + K全部由 GitHub Actions 从打了 tag 的 commit 产出,每个文件附带 .sha256 校验和。
任意 Linux · amd64 与 arm64 · 无需 GTK/WebKit 与显示器
agentmux-server-linux-amd64.tar.gz
agentmux-server-linux-arm64.tar.gz
xattr -dr com.apple.quarantine);Windows 选择「更多信息 → 仍要运行」。
使用 curl -L -O 下载可避免 macOS 隔离属性。
不会。目标、提示词与仓库约定始终归你。编排器只做调查和提案,任何会修改主机的动作都需要你显式审批后才会执行。
远程类 Unix 主机(Linux / macOS)需要 POSIX shell、tmux 与 SSH(缺 tmux 时 AgentMux 可以代装);远程 Windows 主机启用 OpenSSH Server 即可——会话由 AgentMux 自带的守护进程托管,首次使用时经 SFTP 自动部署。本机在 Linux / macOS 直接可用;Windows 上同一台电脑提供两种本机主机——WSL 发行版(tmux 所在),以及原生 Windows(PowerShell,由同一守护进程持久化,关窗口同样不停工作)。
不是。只有本地编排与记忆的语义检索需要 Ollama(一个对话模型 + 一个 embedding 模型)。不装它,应用的其余全部功能完整可用。
不能,这是刻意的边界。Agent 的模型流量从主机直连各家服务商,AgentMux 不代理、也不读取 API Key——因此既报告不了成本,也无法强制预算。
每份安装服务一位操作者:状态、凭据与决策日志都在本工作站上,没有共享服务端、团队账号或集中审计。两个人管同一批主机会看到同样的 tmux 会话,但各自保留历史。
不会。删除工作区或 Agent 记录只是移除本地记录,tmux 会话继续运行。唯一会销毁运行中会话的操作叫 Kill,它会先确认,并明确说明将失去什么。
两条路径。其一,在任意一台 Linux 上跑无头服务端(专用的 agentmux-server-linux-{amd64,arm64},或桌面版加 --serve),平板浏览器访问 http://主机:8642 并输入一次令牌,再「添加到主屏幕」当独立 App 用——iPad 走的就是这条。其二,安卓可以直接装 agentmux-android.apk,它内嵌了完整核心,什么服务端都不用。
serve 模式下核心跑在你的某台机器上,平板只是客户端——好处是手机、平板、桌面看到的是同一份状态。APK 把核心装进了设备本身:SSH 从手机直接发起,配置与密钥存在设备本地,不需要任何一台常开的机器。前台服务保活是必须的——没有它,锁屏后安卓会冻结进程并掐断所有 SSH 连接。
它默认只做令牌鉴权(首次启动生成,存在数据目录的 serve-token)。内网或 VPN 内使用足够;要经公网访问,请放在 HTTPS 反向代理之后,别把明文 HTTP 直接对外。