RunMaestro/Maestro
Agent Orchestration Command Center
Maestro – 管理多個 AI 編碼代理的桌面中心
是什麼 – Maestro 是一個跨平台桌面應用程式，讓您透過以鍵盤為主的介面，執行、組織與自動化數十個 AI 驅動的編碼助手（Claude Code、OpenAI Codex、OpenCode、Factory Droid、Copilot-CLI 等）。每個代理皆被視為獨立的「會話」，擁有自己的檔案系統檢視、Shell 與對話歷史，同時提供並行執行、串接與成本及輸出追蹤功能。
為何重要 – 現代開發者通常會同時使用多個 AI 代碼生成服務。在 CLI、瀏覽器標籤與 IDE 插件之間切換，很快會變得混亂。Maestro 將認證、檔案存取與聊天集中管理，加入強大的自動化（劇本），並提供 Git 友好的並行處理，讓代理能在不同分支上工作而互不干擾。
核心功能（如 README 所述）
| 類別 | 功能 |
|---|---|
| 多代理編排 | 可並行執行無限數量的代理，每個代理擁有獨立的 AI 終端與 Shell 終端；群組聊天 允許主控 AI 將問題路由至多個代理，並合成答案。 |
| 並行開發 | Git Worktrees 集成可為每個代理建立隔離的分支工作區，實現真正的並行編碼與一鍵建立 PR。 |
| 自動化 | 自動執行與劇本 – 基於檔案系統的任務執行器，可執行 Markdown 清單，為每個任務啟動全新 AI 會話並保留完整歷史。 |
| 遠端控制 | 內建 Web 伺服器支援 QR 碼存取；可透過本地網路或 Cloudflare 隧道，從手機或其他裝置遠端存取。 |
| CLI | maestro-cli 支援無頭運作，適用於 cron 任務或 CI 流水線；輸出人類可讀或 JSONL 格式，便於腳本處理。 |
| 容錯性 | 提供方錯誤（如 529 過載）時自動重試，可選備用端點故障轉移，代理忙碌時訊息排隊。 |
| 鍵盤優先 UI | 可自訂快捷鍵、進度追蹤、快速操作面板（Cmd/Ctrl+K），以及即時代理切換（Cmd/Ctrl+J）。 |
| 檔案瀏覽器與檢視器 | 支援語法高亮瀏覽、Markdown 預覽、Mermaid 渲染，以及 JSON/CSV/Parquet 的專用檢視器並支援即時過濾。 |
| 分析與可視化 | 使用情況儀表板（Token/成本統計、熱力圖）與文件圖，可映射 Markdown 檔案間的維基式連結。 |
| 成本與 Token 追蹤 | 即時顯示每個會話與全域的 Token 使用量及成本估算。 |
| 遊戲化進度 | 基於累計自動執行時間的成就與等級（學徒 → 泰坦）。 |
| 主題 | 內建 12 種配色方案（Dracula、Nord、Tokyo Night 等）。 |
典型工作流程
- 新增 AI 提供者 – 認證 Claude Code、Codex、OpenCode 等（Maestro 僅傳遞您已有的憑證）。
- 建立工作樹 – 選擇一個 Git 分支；Maestro 會產生一個子代理，在其獨立目錄中工作。
- 撰寫劇本 – 建立一個 Markdown 清單任務（例如：「產生 API 客戶端 → 執行測試 → 開啟 PR」）。
- 執行自動執行 – Maestro 在每個新 AI 會話中啟動步驟，排隊訊息，並記錄完整對話。
- 監控 – 在使用情況儀表板或透過手機上的遠端 Web UI 查看進度。
- 迭代 – 使用群組聊天提出更高層次的設計問題，讓主控 AI 協調各個編碼代理的回應。
快速上手（來自 README）
# 克隆並啟動開發版本
git clone https://github.com/RunMaestro/Maestro.git
cd Maestro
npm install
npm run dev
或直接從 Releases 頁面下載預建二進位檔。
先決條件 – 至少安裝並認證一個支援的 AI 編碼代理（Claude Code、OpenAI Codex、OpenCode、Copilot-CLI），如需使用工作樹功能則需安裝 Git。
誰應該考慮使用 Maestro？
- 大部分時間在鍵盤上操作、需要快速、輕量滑鼠導航的高階使用者。
- 同時並行運行多個 AI 輔助代碼生成工具的開發者（例如，比較 Claude Code 與 Codex 的輸出）。
- 希望為常規 AI 驅動任務（如骨架生成、重構、PR 生成）建立共享、可重現自動化層（劇本）的團隊。
- 希望在一個地方集中監控多個提供方 Token 使用量與成本的任何人。
許可與社群
- 許可證：AGPL-3.0（任何網路服務的修改版本必須公開原始碼）。
- 支援：Discord 社群、GitHub Issues，以及 https://docs.runmaestro.ai 上的詳盡文件。
總結
Maestro 並非新 AI 模型；它是一個編排層，讓現有編碼助手像一個協調的艦隊一樣協同工作。透過結合 Git 工作樹、自動化劇本、豐富的鍵盤驅動 UI 與容錯功能，它旨在將 AI 增強開發從一系列臨時提示轉變為可重複、可觀測的工作流程。
相關
- 專案
- 專案
- 專案
- 專案
- 專案