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 增强开发从一系列临时提示转变为可重复、可观测的工作流。
相关
- 项目
- 项目
- 项目
- 项目
- 项目