项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 3564
使用教程
ℹ 本教程由 AI 依据该项目 README 整理,个别步骤可能需要按你的环境微调。
环境要求
- 操作系统:跨平台桌面应用,Windows / macOS / Linux 均可
- Node.js 与 npm(用于从源码构建,README 未指定具体版本)
- 至少一个已安装并完成认证的 AI 智能体工具,如 Claude Code、OpenAI Codex 或 OpenCode
- 如需 Auto Run 无人值守执行,需在对应智能体中预先配置好 MCP 工具、技能与权限
安装与启动步骤
-
1下载发行版安装包
最简单的方式:打开 GitHub Releases 页面,下载与你的操作系统匹配的最新发行版安装包并直接安装,无需编译。
-
2克隆源码仓库
如果想从源码构建,先把 Maestro 仓库克隆到本地,再进入项目目录。仓库地址来自 README 的 build from source 部分。
git clone https://github.com/RunMaestro/Maestro.git cd Maestro -
3安装项目依赖
在 Maestro 目录下用 npm 安装依赖,需联网,耗时取决于网络速度;若报错可先检查 Node.js 与 npm 是否可用。
npm install -
4启动开发模式
运行开发启动命令拉起 Maestro 桌面应用。保持终端窗口不要关闭,应用窗口出现后即可开始接入你的智能体。
npm run dev
如何确认成功
npm run dev 终端无报错,并成功弹出 Maestro 桌面应用窗口(README 未说明具体端口)。
常见问题
Q:必须从源码编译吗?
A:不必。README 推荐直接从 Releases 页面下载对应平台的安装包,克隆源码加 npm install、npm run dev 只是备选构建方式。
Q:Maestro 支持哪些 AI 智能体?
A:目前支持 Claude Code、OpenAI Codex、OpenCode、Factory Droid 以及 Copilot-CLI(beta),后续可能按用户需求增加 Gemini CLI 等工具。
Q:需要在 Maestro 里重新配置 MCP、技能和权限吗?
A:不需要。Maestro 是到 AI 服务商的透传通道,你在 Claude Code、Codex 或 OpenCode 中已配置的 MCP 工具、技能、权限与认证均可原样生效。
Q:能长时间无人值守运行吗?
A:可以。Auto Run 会逐条自动执行规格文档中的任务,每个任务使用全新会话和干净上下文,官方记录接近 24 小时连续运行。
注意事项
- README 未给出 Node.js 最低版本要求,若安装失败请自行升级到较新的 LTS 版本。
- Maestro 是桌面应用,交互以键盘为主,不是纯命令行工具或云端服务。
- 每个任务在独立的新会话中执行,因此任务之间不会自动共享上下文,编排时需注意信息传递。
- 发行版安装包请只从官方 GitHub Releases 页面获取,避免使用第三方来源。
核心亮点
- 统一指挥多个主流 AI 编程工具,避免切换上下文
- 支持自定义编排规则,灵活适配不同工作流
- 开源且成长迅速,社区活跃,迭代快
不足之处
- 依赖外部 AI 工具,稳定性受限于各工具 API
- 文档/社区待观察
适用场景
- 需要多个 AI 助手协作完成大型代码重构
- 自动化处理多步骤开发任务,如测试、修复、提交
- 团队统一管理 AI 工具使用策略,提升效率
替代项目
Claude Code、OpenAI Codex CLI、OpenHands
上一篇:ante-preview
下一篇:rea
同类项目推荐
mcp
开源
IBM 官方 MCP 工具集,让大模型快速接上外部工具
A collection of Model Context Protocol (MCP) servers, clients and developer tools by···
mcp-for-blender
开源
用嘴指挥 Blender 建模,说句话就改场景
Community plugin to control Blender 3D with any LLM of your choice. Not affiliated w···
ai-agent-tools-catalog
开源
一站式查找AI智能体现成工具包,快速集成不踩坑
Explore the must-have external ready-made toolkits to integrate with your AI agents ···
smart-customer-service-system
开源
让客服系统能自学,越用越聪明,自动处理问答和业务
构建一个基于大模型的智能客服系统,可提供静态知识问答(静态数据)、动态知识问答(数据库···
ClawCode
开源
让 Claude Code 拥有记忆和社交账号,24小时在线干活
Persistent agents for Claude Code as a plugin, not a harness. Memory, personality, m···
ghostclaw
开源
让 AI 住在你电脑里,动嘴就能干活
an AI that lives on your computer and does stuff for you. Public beta.
ai-assisted-task-executor
开源
一句话指令,AI自动拆解并执行任务,提升办公效率。
A Task-Driven Autonomous Agent System as an AI-powered solution that leverages LLMs,···
marvin
开源
用 Python 装饰器,让任意函数秒变 AI 能力
an ambient intelligence library
adk-js
开源
用 TypeScript 代码构建、评估并部署你的 AI 智能体,掌控每一个细节。
An open-source, code-first Typescript toolkit for building, evaluating, and deployin···
