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：網頁儀表板或行動應用程式允許使用者發送訊息或即時重新導向執行中的工作階段。

適用對象

專為平行執行多個 AI 編碼代理，且需要將它們作為一個團隊來協調（而非管理各自獨立、互不相連的工作階段）的 AI 工程師和開發者設計。

亮點

• 原子性任務管理：防止代理從共享看板宣告任務時發生競態條件。
• 工作器間通訊：支援代理之間帶有原始時間戳記的訊息傳遞。
• 本地優先架構：自我託管、以 SQLite 為後端，並以單一 Rust 二進位檔案散布。
• 動態模型切換：能夠在不遺失上下文的情況下，為執行中的工作器切換模型或供應商。
• 自我修復：包含一個看門狗，用於重新啟動崩潰的工作階段並重播遺漏的訊息。
• 運算 Markdown (DAG)：允許使用 .mdai 檔案進行複雜的多步驟文件與研究合成。