Skip to main content
Maestro hones fractured attention into focused intent. It is built for developers who need to coordinate multiple AI agents, repositories, and long-running tasks without leaving a keyboard-first workflow.

​
Spec-Driven Workflow

Maestro enables a specification-first approach to AI-assisted development. Instead of ad-hoc prompting, you collaboratively build detailed specs with the AI, then execute them systematically:
  1. PLAN — Discuss the feature with the AI agent
  2. SPECIFY — Create markdown docs with task checklists in the Auto Run document folder
  3. EXECUTE — Auto Run works through tasks, spawning a fresh session per task
  4. REFINE — Review results, update specs, and repeat
Why this works:
  • Deliberate planning — Conversation forces you to think through requirements before coding
  • Documented specs — Your markdown files become living documentation
  • Clean execution — Each task runs in isolation with no context bleed
  • Iterative refinement — Review, adjust specs, re-run — specs evolve with your understanding
Example workflow:
  1. Plan: In the AI Terminal, discuss your feature: “I want to add user authentication with OAuth support”
  2. Specify: Ask the AI to help create a spec: “Create a markdown checklist for implementing this feature”
  3. Save: Copy the spec to your Auto Run document folder (or have the AI write it directly)
  4. Execute: Switch to Auto Run tab, select the doc, click Run — Maestro handles the rest
  5. Review: Check the History tab for results, refine specs as needed
This approach mirrors methodologies like Spec-Kit, but with a graphical interface, real-time AI collaboration, and multi-agent parallelism.

​
Key Concepts

ConceptDescription
AgentA Maestro workspace tied to a project directory, backed by a provider (Claude Code, Codex, or OpenCode). Each agent has a Command Terminal and AI Terminal.
ProviderThe underlying AI coding assistant (Claude Code, OpenAI Codex, or OpenCode) that powers an agent.
Session / TabA conversation with the AI provider. Sessions and tabs are 1:1 — each tab represents one session. Agents can have multiple tabs for parallel conversations.
GroupOrganizational container for agents. Group by project, client, or workflow.
Group ChatMulti-agent conversation coordinated by a moderator. Ask questions across multiple agents and get synthesized answers.
Git WorktreeAn isolated working directory linked to a separate branch. Worktree sub-agents appear nested under their parent in the agent list and can create PRs.
AI TerminalThe conversation interface with your AI provider. Supports @ file mentions, slash commands, and image attachments.
Command TerminalA PTY shell for running commands directly. Tab completion for files, git branches, and command history.
Session ExplorerBrowse all past sessions for an agent. Star, rename, search, and resume any previous conversation.
Auto RunAutomated task runner that processes markdown checklists. Spawns a fresh session per task.
PlaybookA saved collection of Auto Run documents with document order, options, and settings for repeatable workflows.
HistoryTimestamped log of all actions (user commands, AI responses, Auto Run completions) with session links.
Remote ControlWeb interface for mobile access. Local network or remote via Cloudflare tunnel.
CLIHeadless command-line tool for scripting, automation, and CI/CD integration.
Provider Pass-ThroughMaestro delegates all AI work to your installed provider (Claude Code, Codex, OpenCode). Your MCP tools, custom skills, permissions, and authentication all carry over—Maestro runs them in batch mode (prompt in, response out) rather than interactive mode.