6ce78b55dc
- Refreshed Git Worktrees README screenshot reference for clearer documentation 📸 - Added new Git Worktrees screenshot asset to docs for updated visuals 🖼️
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.
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.
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.
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+/ |
Full keyboard shortcut reference
Screenshots
Quick Actions palette for rapid navigation
Side-by-side diff viewer with syntax highlighting
12 beautiful themes to match your style
Documentation
Full documentation and usage guide available at docs.runmaestro.ai
- Installation
- Getting Started
- Features Overview
- Auto Run + Playbooks
- Git Worktrees
- Keyboard Shortcuts
- Context Management
- Troubleshooting
Community
- Discord: Join Us
- GitHub Issues: Report bugs & request features
Contributing
See CONTRIBUTING.md for development setup, architecture details, and contribution guidelines.