every ai agent. one terminal dashboard.

stop herding agents.
start conducting.

Maestro spawns and monitors multiple AI coding agents on the same project — live status, real costs, conflict-free worktrees — from one TUI dashboard.

cargo install --git https://github.com/CarlosDanielDev/maestro maestro

brew install carlosdanieldev/tap/maestro --formula

crates.io maestro is an unrelated crate — install from this repo. --formula because an unrelated cask named "maestro" exists in homebrew core.

┏━ maestro · session pool ━━━━━━━━━━━━━━━━┓
┃                                         ┃
┃ ID   ISSUE  STATUS       COST           ┃
┃ s1   #1052  ● RUNNING    $1.24          ┃
┃ s2   #1057  ✓ COMPLETED  $0.87          ┃
┃ s3   #1060  ● RUNNING    $0.42          ┃
┃ s4   #1061  ○ QUEUED     —              ┃
┃ s5   #1062  ✓ COMPLETED  $1.09          ┃
┃                                         ┃
┃ ◆ 5 sessions   ✓ 2 completed   Σ $3.62  ┃
┃                                         ┃
┃ $ ▌                                     ┃
┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛

F1 Help  F2 Summary  F3 Full  F4 Costs  F5 Tokens
F6 Deps  F9 Pause  F10 Kill  Ctrl+X Exit

features

six things it does, plainly

Multi-session pool — run up to N concurrent agent sessions with automatic queue promotion.
Git worktree per session — sessions do not step on each other's files.
Rich activity log — file paths, command previews, tool durations.
Completion gates — fmt, clippy, test, or any custom command, run after every session.
Automated PR creation — with a cost report and file list, on session completion.
Mixed providers — Claude, Codex, Qwen, OpenCode, Ollama, and MiniMax side by side in [agents].

quickstart

from install to first session

maestro init                                              # interactive maestro.toml setup
maestro init --non-interactive                            # headless GitHub defaults
maestro doctor                                            # verify gh/az/agent CLI/git
maestro run --prompt "Refactor the auth module to async"  # ad-hoc session
maestro run --issue 42                                    # session for a GitHub issue
maestro run --milestone "v1.0"                            # all open issues in a milestone
maestro                                                   # open the TUI dashboard

honest boundaries

three things it will not pretend to be

not autonomous by default.

Sessions stop at your configured gates and the PR waits for your review. Continuous mode and auto-merge exist, but both are opt-in.

not a ci replacement.

No hosted runners, no yaml pipelines. It is a local TUI driving real agent CLIs on your machine, in your terminal.

not a prompt wrapper.

A real state machine, one git worktree per session, a file-claim registry against edit collisions, and cost tracking per session.