mirror of https://github.com/jlengrand/Maestro.git synced 2026-03-10 08:31:19 +00:00

Files

Pedram Amini 6ce78b55dc ## CHANGES

- Refreshed Git Worktrees README screenshot reference for clearer documentation 📸
- Added new Git Worktrees screenshot asset to docs for updated visuals 🖼️

2025-12-28 04:21:42 -06:00

6.3 KiB

Raw Blame History

Maestro

Maestro hones fractured attention into focused intent.

Maestro is a cross-platform desktop app for orchestrating your fleet of AI coding agents. Built for power users who live on the keyboard and rarely touch the mouse.

Run multiple agents in parallel with a Linear/Superhuman-level responsive interface. Currently supporting Claude Code, OpenAI Codex, and OpenCode with plans for additional agentic coding tools based on user demand.

Power Features

Auto Run & Playbooks

Batch-process markdown checklists through AI agents. Create task documents with checkboxes, and Maestro works through them automatically—spawning fresh AI sessions for each task with clean context. Save configurations as playbooks for repeatable workflows, run in loops, and track everything in history.

Learn more about Auto Run

Git Worktrees

Run AI agents in parallel on isolated branches. Create worktree sub-agents from the git branch menu, each operating in their own directory. Work interactively in the main repo while sub-agents process tasks independently—then create PRs with one click.

Learn more about Git Worktrees

Group Chat

Coordinate multiple AI agents in a single conversation. A moderator AI orchestrates discussions, routing questions to the right agents and synthesizing their responses for cross-project questions and architecture discussions.

Learn more about Group Chat

Remote Access

Built-in web server with QR code access. Monitor and control all your agents from your phone. Supports local network access and remote tunneling via Cloudflare for access from anywhere—no account required.

Learn more about Remote Access

Command Line Interface

Full CLI (maestro-cli) for headless operation. List agents/groups, run playbooks from cron jobs or CI/CD pipelines, with human-readable or JSONL output for scripting.

Learn more about the CLI

Core Features

Feature	Description
Multi-Agent Management	Run unlimited agents in parallel with isolated workspaces and conversation histories
Dual-Mode Sessions	Switch between AI Terminal and Command Terminal with `Cmd+J`
Keyboard-First Design	Full keyboard control with customizable shortcuts and mastery tracking
Session Discovery	Automatically discovers existing sessions from all supported providers
Git Integration	Branch display, diff viewer, commit logs, and git-aware file completion
File Explorer	Browse files with syntax highlighting, markdown preview, and `@` mentions
Message Queueing	Queue messages while AI is busy; they're sent when the agent is ready
Output Filtering	Search and filter with include/exclude modes and regex support
Slash Commands	Extensible command system with autocomplete, template variables and spec-kit support.
Audio Notifications	Text-to-speech announcements when agents complete tasks
Cost Tracking	Real-time token usage and cost monitoring
12 Beautiful Themes	Dracula, Monokai, Nord, Tokyo Night, GitHub Light, and more
Achievements	11 conductor-themed ranks based on cumulative Auto Run time

Quick Start

Installation

Download the latest release for your platform from the Releases page.

Or build from source:

git clone https://github.com/pedramamini/Maestro.git
cd Maestro
npm install
npm run dev

Essential Keyboard Shortcuts

Action	macOS	Windows/Linux
Quick Actions	`Cmd+K`	`Ctrl+K`
New Agent	`Cmd+N`	`Ctrl+N`
Switch AI/Terminal	`Cmd+J`	`Ctrl+J`
Previous/Next Agent	`Cmd+[` / `Cmd+]`	`Ctrl+[` / `Ctrl+]`
Toggle Sidebar	`Cmd+B`	`Ctrl+B`
New Tab	`Cmd+T`	`Ctrl+T`
All Shortcuts	`Cmd+/`	`Ctrl+/`