What is Maestro?
FreshMaestro is a cross-platform desktop application (Electron-based) for orchestrating fleets of AI coding agents across multiple projects simultaneously.
Key Concept
Maestro is NOT an AI itself. It's a pass-through orchestrator — a management layer that sits above AI providers. Whatever MCP tools, skills, permissions, or authentication you have configured in those providers works identically in Maestro.
How It Works
The key difference from running agents directly: Maestro runs them in batch/print mode rather than interactively, enabling:
- Unattended automation — Auto Run processes markdown checklists while you sleep
- Parallel multi-agent workflows — Multiple agents working on different branches simultaneously
- Cross-agent coordination — Group Chat with a moderator AI routing between agents
- Remote execution — SSH agents running on remote machines, controlled from your desktop
Record
Nearly 24 hours of continuous unattended Auto Run runtime.
Supported Providers
| Provider | Status | Key Feature |
|---|---|---|
| Claude Code | Primary | Full cost tracking, slash commands, session resume |
| OpenAI Codex | Full support | YOLO mode, reasoning tokens (o3/o4-mini) |
| OpenCode | Full support | 75+ LLM providers (Ollama, LM Studio, llama.cpp) |
| Factory Droid | Active | Stream JSON output |
| Gemini CLI | Planned | Coming soon |
| Qwen3 Coder | Planned | Coming soon |
What's in This Guide
- Installation — Get Maestro running on any platform
- First Launch — Set up your first agent
- Provider Configuration — Configure each AI provider
- Settings — Customize everything
See Also
- Auto Run & Playbooks — The core automation engine
- Keyboard Shortcuts — Complete shortcut reference
- Troubleshooting — Common issues and fixes