mixpeek/amux

解决的问题

amux 提供了一个集中式控制平面，用于同时管理多个 AI 编码代理（例如 Claude Code、Codex、Gemini CLI 和 Ollama）。它解决了协调并行工作器“舰队”的问题，防止任务重复，并提供一个统一界面来引导、监控和调度自主代理的运行。

工作原理

amux 以单一 Rust 二进制文件构建并使用 SQLite 作为后端，作为一个协调器来管理代理会话（通常通过 tmux）。它使用一组核心原语来协调工作：

• Board：一个共享看板，具有原子性认领机制，确保不会有两个工作器抢夺同一个任务。
• Workers：并行代理会话，具有持久身份，并能够窥视同伴的终端。
• Schedules：Cron 风格的周期性提示，用于自主的夜间或定期运行。
• Groups & Scope：工作器的逻辑组织，共享内存、环境变量和访问门控。
• .mdai Files：一个“计算 Markdown 文件”系统，构成一个有向无环图 (DAG)。这些文件使用模型将来自其他文件或文件夹的信息合成为最终输出，并内置缓存和循环检测功能。
• Steering：Web 仪表板或移动应用程序允许用户发送消息或实时重定向正在运行的会话。

适用人群

专为并行运行多个 AI 编码代理，且需要将它们作为一个团队来协调（而不是管理各自独立、互不相连的会话）的 AI 工程师和开发者设计。

亮点

• 原子任务管理：防止代理从共享看板认领任务时发生竞态条件。
• 工作器间通信：支持代理之间带有原始时间戳的消息传递。
• 本地优先架构：自托管、以 SQLite 为后端，并作为单一 Rust 二进制文件分发。
• 动态模型切换：能够在不丢失上下文的情况下，为正在运行的工作器切换模型或提供商。
• 自我修复：包含一个看门狗，用于重启崩溃的会话并重播错过的消息。
• 计算 Markdown (DAG)：允许使用 .mdai 文件进行复杂的多步骤文档和研究合成。