Maestro

Maestro 将分散的注意力凝聚为专注的意图。

Maestro 是一款跨平台桌面应用，用于编排（orchestrating）你的 AI 智能体（agent）舰队和项目。它是为同时并行处理多个项目的黑客（hacker）打造的高速解决方案，专为重度依赖键盘、极少使用鼠标的高级用户设计。

与 AI 协作创建详细的规格文档，然后让 Auto Run 自动执行它们——每个任务都在一个全新的会话中运行，并拥有干净的上下文。支持长时间无人值守的运行，我目前的记录是接近 24 小时的连续运行时间。

以媲美 Linear/Superhuman 的响应速度界面并行运行多个智能体。目前已支持 Claude Code、OpenAI Codex、OpenCode 和 Factory Droid，并计划根据用户需求增加更多智能体编程工具（如 Gemini CLI、Qwen3 Coder）。

工作原理： Maestro 是你所用 AI 提供商的直通层（pass-through）。你在 Claude Code、Codex 或 OpenCode 中配置的任何 MCP 工具、技能、权限或认证，在 Maestro 中都能完全一致地工作。唯一的区别在于，我们并非以交互方式运行——每个任务都会收到一个提示（prompt）并返回一个响应，无论是新会话还是恢复之前的会话。

功能特性

高级功能

• 🌳 Git 工作树（Git Worktrees） - 在隔离的分支上并行运行 AI 智能体。从 Git 分支菜单创建工作树子智能体，每个子智能体在自己的目录中独立运行。你可以在主仓库中交互式工作，而子智能体则独立处理任务——完成后一键创建 PR。实现真正无冲突的并行开发。
• 🤖 自动运行（Auto Run）与剧本（Playbooks） - 基于文件系统的任务运行器，通过 AI 智能体批量处理 Markdown 待办清单。为可重复的工作流创建剧本，支持循环运行，并通过完整历史记录跟踪进度。每个任务都拥有独立的 AI 会话，确保对话上下文干净。
• 💬 群组聊天（Group Chat） - 在单一对话中协调多个 AI 智能体。由一个主持人 AI 编排讨论，将问题路由给合适的智能体，并综合其回答，适用于跨项目问题和架构讨论。
• 🌐 移动端远程控制（Mobile Remote Control） - 内置 Web 服务器，通过二维码访问。从手机监控和控制所有智能体。支持本地网络访问，并可通过 Cloudflare 隧道实现远程访问。
• 💻 命令行界面（CLI） - 完整的命令行工具（maestro-cli），支持无头（headless）操作。可列出智能体/群组、从 cron 作业或 CI/CD 流水线运行剧本，并输出人类可读格式或 JSONL 格式以供脚本使用。
• 🚀 多智能体管理 - 并行运行无限数量的智能体和终端会话。每个智能体拥有独立的工作区、对话历史和隔离的上下文。
• 📬 消息队列（Message Queueing） - 当 AI 忙碌时，可将消息排队；一旦智能体就绪，消息将自动发送。永不丢失任何想法。

核心功能

• 🔄 双模式会话 - 每个智能体同时拥有 AI 终端和命令终端。通过 Cmd+J 在 AI 对话与 Shell 命令之间无缝切换。
• ⌨️ 键盘优先设计（Keyboard-First Design） - 全键盘控制，支持自定义快捷键，并配备熟练度追踪（mastery tracking），随着你技能提升给予奖励。Cmd+K 快速操作、快速切换智能体、专注状态管理，助你进入心流（flow state）。
• 📋 会话发现（Session Discovery） - 自动发现并导入所有已支持提供商的现有会话，包括安装 Maestro 之前的对话。可浏览、搜索、收藏、重命名并恢复任意会话。
• 🔀 Git 集成 - 自动检测代码仓库、显示当前分支、内置差异查看器（diff viewer）、提交日志，以及具备 Git 感知能力的文件补全。无需离开应用即可高效使用 Git。
• 📁 文件浏览器（File Explorer） - 浏览项目文件，支持语法高亮、Markdown 预览和图片查看。在提示词中通过 @ 提及引用文件。
• 🔍 强大的输出过滤（Powerful Output Filtering） - 支持包含/排除模式、正则表达式，以及针对每条响应的本地过滤器，用于搜索和筛选 AI 输出。
• ⚡ 斜杠命令（Slash Commands） - 可扩展的命令系统，带自动补全功能。可使用模板变量为你的工作流创建自定义命令。
• 💾 草稿自动保存 - 永不丢失工作内容。草稿按会话自动保存并恢复。
• 🔊 语音通知（Speakable Notifications） - 当智能体完成任务时，通过文本转语音（TTS）播放音频提醒。
• 🎨 精美主题（Beautiful Themes） - 提供 12 种主题，包括 Dracula、Monokai、Nord、Tokyo Night、GitHub Light 等。
• 💰 成本追踪（Cost Tracking） - 实时追踪每个会话及全局的 Token 使用量和费用。
• 🏆 成就系统（Achievements） - 根据累计 Auto Run 运行时间，从“学徒（Apprentice）”逐步升级至“指挥大师（Titan of the Baton）”。共有 11 个以指挥家为主题的等级等待解锁。

分析与可视化

• 📊 使用情况仪表盘（Usage Dashboard） - 提供全面的分析功能，用于追踪所有会话中的 AI 使用模式。支持多种时间范围（日、周、月、年、全部时间）的聚合统计，可比较不同智能体（agent）的表现，分析用户活动与自动运行（Auto Run）活动的分布，并探索活动热力图。包含 CSV 导出、实时更新以及可配置的色盲友好调色板。可通过 Opt+Cmd+U（macOS）或 Alt+Ctrl+U（Windows/Linux）快捷键，或通过 Command K 菜单访问。
• 🕸️ 文档关系图（Document Graph） - 可视化你的 Markdown 文档知识图谱。自动识别内部的 [[wiki-links]] 和 [markdown](links) 链接，以交互式节点和边展示文档之间的关系。支持在力导向布局（force-directed）和层级布局（hierarchical）之间切换，可搜索/筛选文档，通过键盘导航，并追踪外部链接引用。对于大型目录，还提供小地图（mini-map）、图例（legend）和分页功能。可通过文件资源管理器上下文菜单或 Command K 菜单访问。

分析功能的键盘快捷键

使用情况仪表盘 (Opt+Cmd+U / Alt+Ctrl+U)：

操作	按键
在视图标签间导航	方向键（左/右/上/下）
在各区域间移动	Tab / Shift+Tab
跳转到第一个/最后一个区域	Home / End
关闭仪表盘	Escape

文档关系图 (Command K → "Document Graph")：

操作	按键
导航到相连节点	方向键（上/下/左/右）
循环切换连接	Tab
打开选中的文档/链接	Enter
关闭关系图	Escape
搜索文档	聚焦搜索框后输入查询

其他交互方式：拖拽节点重新定位，滚动缩放，使用小地图查看整体概览。

注意：Maestro 支持 Claude Code、OpenAI Codex、OpenCode 和 Factory Droid。未来版本可能会根据社区需求增加对其他智能体（如 Gemini CLI、Qwen3 Coder）的支持。

快速开始

安装

从 Releases 页面 下载适用于你平台的最新版本。

或从源码构建：

git clone https://github.com/RunMaestro/Maestro.git
cd Maestro
npm install
npm run dev

依赖要求

• 至少安装并认证一个受支持的 AI 编码智能体：
  • Claude Code - Anthropic 的 AI 编程助手
  • OpenAI Codex - OpenAI 的编程智能体
  • OpenCode - 开源 AI 编程助手
• Git（可选，用于支持 Git 相关功能）

常用键盘快捷键

操作	macOS	Windows/Linux
快速操作（Quick Actions）	Cmd+K	Ctrl+K
新建智能体（New Agent）	Cmd+N	Ctrl+N
切换 AI/终端	Cmd+J	Ctrl+J
上一个/下一个智能体	Cmd+[ / Cmd+]	Ctrl+[ / Ctrl+]
切换侧边栏	Cmd+B	Ctrl+B
新建标签页	Cmd+T	Ctrl+T
使用情况仪表盘	Opt+Cmd+U	Alt+Ctrl+U
查看所有快捷键	Cmd+/	Ctrl+/

完整快捷键参考

截图

主界面显示多个智能体及其对话

群聊（Group Chat）在同一对话中协调多个 AI 智能体

快速操作面板，用于快速导航（CTRL/CMD + K）

带有语法高亮的 Git 差异查看器

查看更多...

文档

完整文档和使用指南请访问 docs.runmaestro.ai

• 安装指南
• 入门教程
• 功能概览
• 自动运行 + 剧本（Auto Run + Playbooks）
• Git 工作树（Git Worktrees）
• 键盘快捷键
• 上下文管理（Context Management）
• MCP Server - 将 AI 应用连接到 Maestro 文档
• 故障排除

社区

• Discord: 加入我们
• GitHub Issues: 报告 Bug 与功能请求

团队

了解 Maestro 背后的团队：runmaestro.ai/team

贡献

有关开发环境搭建、架构细节和贡献指南，请参阅 CONTRIBUTING.md。

许可证

AGPL-3.0 许可证

Maestro 快速上手指南

环境准备

• 操作系统：支持 macOS、Windows 和 Linux
• 前置依赖：
  • 至少安装并配置以下任一 AI 编码代理（需完成身份认证）：
    • Claude Code
    • OpenAI Codex
    • OpenCode
  • （可选）安装 Git，以启用 Git 相关功能（如分支管理、diff 查看等）

注意：Maestro 本身不提供 AI 模型，仅作为你已有 AI 工具的调度器和增强界面。

安装步骤

方法一：下载预编译版本（推荐）

前往 GitHub Releases 页面 下载对应平台的安装包。

国内用户若下载缓慢，可尝试使用 GitHub 加速镜像（如 https://ghproxy.com/）或通过代理下载。

方法二：从源码构建

git clone https://github.com/RunMaestro/Maestro.git
cd Maestro
npm install
npm run dev

建议使用国内 npm 镜像加速依赖安装，例如：

npm install --registry https://registry.npmmirror.com

基本使用

1. 启动 Maestro
   安装完成后直接运行应用。

2. 创建新 Agent
   使用快捷键 Cmd+N（macOS）或 Ctrl+N（Windows/Linux）新建一个 AI Agent。
   Maestro 会自动检测你已配置的 AI 工具（如 Claude Code、Codex 等）。

3. 与 AI 协作

   • 在 AI Terminal 中输入任务描述（例如：“生成一个 Python Flask 的 Hello World 应用”）
   • 使用 @文件名 引用项目中的文件
   • 按 Enter 发送，AI 将在独立会话中执行任务

4. 切换终端模式
   按 Cmd+J / Ctrl+J 可在 AI 对话与 Shell 命令终端之间快速切换。

5. 运行自动化任务（Auto Run）
   创建一个 Markdown 格式的 checklist 文件（即 Playbook），例如：

   - [ ] 初始化项目结构
   - [ ] 编写主程序
   - [ ] 添加单元测试
   

   然后通过 Cmd+K → “Run Playbook” 启动自动执行，每个任务将在干净的 AI 会话中运行。

提示：按 Cmd+K / Ctrl+K 打开命令面板，可快速访问所有功能。