一个仪表盘并行编排多个 AI CLI 编码代理，共享任务板并支持手机远程操控

方案简介

amux 是一个「AI 工程团队」编排器：它在同一个仪表盘（或手机）上并行运行 Claude Code、Codex、Gemini CLI 等多个 AI 编码代理，让它们共享任务板、互相通信、崩溃后自动恢复，从而持续交付代码。适合希望同时推进多个编码任务、又不想在多个终端之间手动切换协调的开发者。整套方案本地优先，只用一个 Rust 二进制加 SQLite，数据留在自己的机器上；需要远程访问时，通过把 amux 放到 Tailscale tailnet 上，即可在不开放端口的情况下从手机或另一台电脑安全连入，iPhone/iPad/Mac 原生应用均直接连接该地址。

亮点与能力

• 共享任务板：认领卡片是原子操作，两个代理不会抢同一份工作。
• 代理互发消息：代理可以互相提问、交接、解除阻塞，无需你中转。
• 自愈能力：崩溃或卡住的会话会重启并从断点继续。
• 调度与循环：支持 daily at 9am、every 15m，或自我节流的通宵运行。
• 全端操控：通过 iPhone/iPad 应用、Mac 应用或浏览器观看、操控与批准。
• 任意模型：Claude Code、Codex、Gemini CLI、OpenCode 或 Ollama，可按 worker 切换。
• 本地优先：一个 Rust 二进制加 SQLite，数据在自己机器上。

组成与分工

• amux：核心编排器，提供仪表盘、共享任务板、代理间通信、会话自愈与调度，本体是一个 Rust 二进制加 SQLite。
• Claude Code / Codex / Gemini CLI：实际执行编码任务的 AI 代理 CLI，作为 worker 被 amux 并行调度，可按 worker 切换。
• tmux：终端复用器，承载代理会话，是运行前置要求（3.2+）。
• Tailscale：零端口暴露的远程访问通道，amux 直接服务 tailnet 的 HTTPS 证书。
• SQLite：本地持久化存储，配合 Rust 二进制实现本地优先。

前置要求

• tmux 3.2+
• 至少一个代理 CLI（Claude Code、Codex 或 Gemini CLI）
• 操作系统：macOS 或 Linux
• amux 会克隆自身到 ~/Dev/amux，数据保存在 ~/.amux

安装（一条命令，会先询问再安装 Rust、tmux 等依赖）：

curl -fsSL https://amux.io/install.sh | bash

或先阅读再安装：

git clone https://github.com/mixpeek/amux && cd amux && ./install.sh

实施步骤

1. 安装 amux

curl -fsSL https://amux.io/install.sh | bash

安装脚本会克隆 amux 到 ~/Dev/amux，并在安装任何东西（Rust、tmux）之前先询问你。### 2. 打开仪表盘

安装完成后打开 https://localhost:8824。

3. 添加代理 CLI

确保已安装至少一个代理 CLI：Claude Code、Codex 或 Gemini CLI。在 worker 中即可运行，并支持按 worker 切换模型。

4.（可选）配置手机/远程访问

不开端口的情况下，把 amux 放到 Tailscale tailnet 上：amux 会服务 tailnet 的 HTTPS 证书，iPhone、iPad 和 Mac 应用直接连接该地址即可。

使用与配置要点

• 仪表盘默认地址为 https://localhost:8824，所有应用（Mac、iPhone/iPad、浏览器）都连接到你的 amux 服务器地址。
• 用共享任务板分配任务：认领卡片是原子的，避免代理撞单。
• 用 daily at 9am、every 15m 等表达式设置定时与循环任务。
• 崩溃或卡住的会话会自动重启并从断点继续，无需人工干预。
• 从本机迁移到 amux Cloud：先 amux export，再 amux import --to https://.amux.io 即可搬走配置。

注意事项与常见问题

• 许可证为 MIT + Commons Clause：可自由使用、修改和自托管，但不允许售卖 amux 本身。
• Mac 应用尚未公证：从浏览器下载 .dmg 或 .zip 后首次打开会被 macOS 拦截，需到「系统设置 > 隐私与安全性」点击 Open Anyway。
• 本项目（amux.io, github.com/mixpeek/amux）与 amux.sh 或 github.com/andyrewlee/amux 无关联。
• 依赖 tmux 3.2+，且至少需要一个代理 CLI 才能实际运行任务。

优缺点

• ✓ 多代理并行且任务认领原子化
• ✓ 崩溃自愈、本地优先数据自主
• ✕ 依赖 tmux 3.2+ 且需至少一个代
• ✕ Mac 应用未公证首次打开受限

出处

本方案挖掘自开源项目 mixpeek/amux，方案内容与实施命令均来自其 README 原文。