阿超 > Maestro

Maestro

2026-02-07

ai

庸人费心将是消磨时光，能人费尽心机利用时光。——叔本华

Maestro：把你的“多代理工作室”搬到桌面

在 AI 代理越来越多、项目分支越来越复杂的今天，很多人需要一个“指挥台”：既能让多个代理并行在不同项目/分支上工作，又能把规范、任务清单、复盘数据都沉在同一个地方。Maestro 就是这样的桌面应用——一个跨平台的多代理���排与管理中心，面向“高频切换、键盘为主”的深度使用者。

  • 仓库：pedramamini/Maestro
  • 主页与文档：RunMaestro.ai · docs.runmaestro.ai
  • 简述：Agent Orchestration Command Center
  • 支持代理：Claude Code、OpenAI Codex、OpenCode、Factory Droid（后续计划看社区需求）
  • 许可：AGPL-3.0
  • 语言与平台：TypeScript，跨平台桌面应用

官方一句话很到位：Maestro hones fractured attention into focused intent——把分散的注意力，磨成专注的意图。

它解决什么问题

  • 多项目并行：同时运行多个代理和终端会话，每个代理有独立工作区、历史与上下文
  • 规范化执行：用规格文档与 Auto Run 把任务清单交给代理批处理，形成可复用的 Playbook
  • Git 深度整合：自动识别仓库、展示分支与 diff、日志；支持 worktrees 做真正的并行开发
  • 键盘优先：完整快捷键系统与“掌握度”追踪（Keyboard Mastery）
  • 分布式协作：群聊把多个代理拉到一个对话里，由主持代理协调与汇总
  • 可视化与数据：使用仪表盘、文档图谱，把你的工作与知识结构“看得见”

功能全景：从“Power Features”到“Core Features”

  • Power Features

    • Git Worktrees：每个子代理在独立 worktree 分支上工作，主仓与子代理可并行，最后一键发 PR
    • Auto Run & Playbooks：面向文件系统的任务运行器，把 markdown 清单批处理给代理，可循环、可记录
    • Group Chat：由主持代理协调多个代理在一个会话里讨论与决策
    • Mobile Remote Control：内置 Web 服务 + 二维码，手机监控与控制；支持 Cloudflare 隧道远程访问
    • CLI（maestro-cli）：无界面运行，列代理/群组、跑 Playbook，支持 JSONL 便于脚本化

  • Core Features

    • Dual-Mode Sessions：每个代理同时拥有 AI Terminal 与 Command Terminal，Cmd+J 一键切换
    • Keyboard-First：完整快捷键与追踪，Cmd+K 快速操作、快速切换代理、焦点管理
    • Session Discovery：自动发现并导入支持供应商的既有会话，检索与恢复无缝进行
    • Git Integration：分支显示、diff 视图、提交日志、git 感知的文件补全
    • File Explorer：浏览项目文件，语法高亮、Markdown 预览、图片查看，提示里可 @ 引用文件
    • Output Filtering：对 AI 输出做包含/排除、正则与局部过滤
    • Slash Commands：可扩展的斜杠命令系统，支持模板变量
    • Draft Auto-Save：草稿自动保存与恢复
    • Speakable Notifications：任务完成时的 TTS 提示
    • 主题与成本：多套主题、美学风格；实时 token 使用与成本追踪
    • Achievements：基于 Auto Run 累积时长解锁“指挥家”主题段位

分析与可视化：Usage Dashboard 与 Document Graph

  • Usage Dashboard：跨会话的使用分析，按天/周/月/年统计，支持比较不同代理的表现、用户 vs Auto Run 分布、热力图、CSV 导出、实时更新与色盲友好配色
  • Document Graph：Markdown 的知识图谱，自动识别 [[wiki-links]] 与 [markdown](links)，用节点与连线展示结构；支持强制导向/层级布局、过滤与键盘导航，带 mini‑map、图例与分页

快捷键（节选）：

  • 使用仪表盘：Opt+Cmd+U（macOS） / Alt+Ctrl+U（Windows/Linux）
  • 在文档图谱中导航：方向键移动、Tab 切连接、Enter 打开选中项、Escape 关闭

它怎么接入你的代理生态

Maestro 是“AI 供应商的直通车”：你在 Claude Code、Codex 或 OpenCode 里配置的 MCP 工具、技能、权限与认证，Maestro 会同样使用，差别只在于交互方式——它按任务驱动，不需要持续互动。

How It Works: Maestro is a pass-through to your AI provider. Whatever MCP tools, skills, permissions, or authentication you have configured in Claude Code, Codex, or OpenCode works identically in Maestro.

安装与源码运行

直接下载发布版或从源码跑起来：

1
2
3
4
git clone https://github.com/pedramamini/Maestro.git
cd Maestro
npm install
npm run dev

必要条件：

  • 至少安装并认证一个支持的 AI 代理（Claude Code / OpenAI Codex / OpenCode 等）
  • Git（可选，用于 git 感知功能）

必备快捷键清单（节选）

1
2
3
4
macOS: Cmd+K（快速操作）、Cmd+N（新代理）、Cmd+J（切 AI/终端）、Cmd+[ / Cmd+]（切换代理）、
Cmd+B（侧栏）、Cmd+T（新标签）、Opt+Cmd+U（仪表盘）、Cmd+/（所有快捷键）

Win/Linux: Ctrl+K、Ctrl+N、Ctrl+J、Ctrl+[ / Ctrl+]、Ctrl+B、Ctrl+T、Alt+Ctrl+U、Ctrl+/

完整列表见文档：Keyboard Shortcuts

一个工作日的“Maestro 流程”：例子

  • 上午：把本周目标写成规范文档，拆成 Markdown 任务清单，交给 Auto Run 跑起来；每条任务在独立会话里执行，上下文干净
  • 并行：为仓库创建多个 worktree，派子代理在各分支修问题；主仓继续交互开发，最后一键生成 PR
  • 协同：开 Group Chat，把几个代理拉进来讨论跨项目架构，主持代理负责分发问题与综合结论
  • 可视化：用 Document Graph 检查知识库关联，补全链接与断点；用 Usage Dashboard 看代理用量与成本
  • 远控：手机上用 QR 码连上本机服务，随时查看进度与发指令
  • CLI：在 CI 里用 maestro-cli 执行 Playbook，输出 JSONL 便于分析

为什么它特别适合“码农 + 代理”的日常

  • 键盘流：不打断“心流”，一切都有快捷键与清晰的焦点管理
  • 分支并发：worktrees 让真正的“并行开发”变成常态
  • 规范复用：Playbooks 把“正确的做事方法”固化下来，团队共享
  • 审核与成本：实时的 token/cost 追踪 + 用量仪表盘，有据可依
  • 与供应商无缝：把你在 Claude Code/Codex/OpenCode 的配置一键“搬来用”

结语

Maestro 不是再造一个“聊天界面”，而是给多代理与工程实践搭了一个“指挥台”。它把工作流、分支、任务清单、协作与观察，用统一的桌面体验串起来。
如果你已经在多个项目与代理之间穿梭，想把“并行且可控”做成日常，试试 Maestro：从 Cmd+K 开始，把你的注意力磨成可执行的意图。