# Maestro

> Maestro hones fractured attention into focused intent.

## Docs

- [Overview](https://runmaestro-feat-autonomous-manager-agent.mintlify.app/about/overview.md): Learn about Maestro's spec-driven workflow for AI-assisted development with multiple agents.
- [Achievements](https://runmaestro-feat-autonomous-manager-agent.mintlify.app/achievements.md): Level up through 11 conductor-themed ranks based on your cumulative Auto Run time.
- [Auto Run + Playbooks](https://runmaestro-feat-autonomous-manager-agent.mintlify.app/autorun-playbooks.md): Process markdown checklists with AI agents using Auto Run documents and reusable Playbooks.
- [BMAD Commands](https://runmaestro-feat-autonomous-manager-agent.mintlify.app/bmad-commands.md): Use BMAD Method workflows inside Maestro's AI Commands panel.
- [Command Line Interface](https://runmaestro-feat-autonomous-manager-agent.mintlify.app/cli.md): Send messages to agents, list sessions, run playbooks, and manage Maestro settings from the command line.
- [Configuration](https://runmaestro-feat-autonomous-manager-agent.mintlify.app/configuration.md): Settings overview, updates, storage locations, and cross-device sync.
- [Context Management](https://runmaestro-feat-autonomous-manager-agent.mintlify.app/context-management.md): Compact, merge, and transfer conversation context between sessions and agents.
- [Deep Links](https://runmaestro-feat-autonomous-manager-agent.mintlify.app/deep-links.md): Navigate to specific agents, tabs, and groups using maestro:// URLs from external apps, scripts, and OS notifications.
- [Director's Notes](https://runmaestro-feat-autonomous-manager-agent.mintlify.app/director-notes.md): Aggregate history from all agents into a unified timeline with AI-powered synopsis generation.
- [Document Graph](https://runmaestro-feat-autonomous-manager-agent.mintlify.app/document-graph.md): Visualize markdown file relationships and wiki-link connections in an interactive graph view.
- [Encore Features](https://runmaestro-feat-autonomous-manager-agent.mintlify.app/encore-features.md): Optional, feature-gated capabilities that let Maestro ship fast without bloating the core experience.
- [Features](https://runmaestro-feat-autonomous-manager-agent.mintlify.app/features.md): Explore Maestro's power features including Git Worktrees, Auto Run, Group Chat, and Remote Control.
- [Feedback](https://runmaestro-feat-autonomous-manager-agent.mintlify.app/feedback.md): Submit bug reports and feature requests through Maestro's conversational feedback system.
- [General Usage](https://runmaestro-feat-autonomous-manager-agent.mintlify.app/general-usage.md): Learn the Maestro UI layout, agent status indicators, file explorer, and output filtering.
- [Getting Started](https://runmaestro-feat-autonomous-manager-agent.mintlify.app/getting-started.md): Get from install to your first productive session with Maestro in minutes.
- [Git and Worktrees](https://runmaestro-feat-autonomous-manager-agent.mintlify.app/git-worktrees.md): Browse commit history, view diffs, and run AI agents in parallel on isolated branches with Git worktree sub-agents.
- [Group Chat](https://runmaestro-feat-autonomous-manager-agent.mintlify.app/group-chat.md): Coordinate multiple AI agents in a single conversation with a moderator AI.
- [History](https://runmaestro-feat-autonomous-manager-agent.mintlify.app/history.md): Track all agent activity with searchable, filterable history including Auto Run completions and user annotations.
- [Image Annotator](https://runmaestro-feat-autonomous-manager-agent.mintlify.app/image-annotator.md): Mark up screenshots and other images with freehand strokes, shapes, arrows, and text before sending them to your AI agents.
- [Maestro](https://runmaestro-feat-autonomous-manager-agent.mintlify.app/index.md): Cross-platform desktop app for orchestrating multiple AI coding agents with a keyboard-first interface.
- [Installation](https://runmaestro-feat-autonomous-manager-agent.mintlify.app/installation.md): Download and install Maestro on macOS, Windows, or Linux.
- [Keyboard Shortcuts](https://runmaestro-feat-autonomous-manager-agent.mintlify.app/keyboard-shortcuts.md): Complete reference for Maestro keyboard shortcuts, tab completion, and mastery tracking.
- [Local Manifest](https://runmaestro-feat-autonomous-manager-agent.mintlify.app/local-manifest.md): Extend the Playbook Exchange with custom or work-in-progress playbooks stored locally.
- [Cue Overview](https://runmaestro-feat-autonomous-manager-agent.mintlify.app/maestro-cue.md): Event-driven automation that triggers agent prompts in response to file changes, timers, agent completions, GitHub activity, and pending tasks.
- [Cue Advanced Patterns](https://runmaestro-feat-autonomous-manager-agent.mintlify.app/maestro-cue-advanced.md): Fan-in/fan-out, payload filtering, agent chaining, template variables, and concurrency control.
- [Cue Configuration](https://runmaestro-feat-autonomous-manager-agent.mintlify.app/maestro-cue-configuration.md): Complete YAML schema reference for .maestro/cue.yaml configuration files.
- [Cue Event Types](https://runmaestro-feat-autonomous-manager-agent.mintlify.app/maestro-cue-events.md): Detailed reference for all ten Maestro Cue event types with configuration, payloads, and examples.
- [Cue Examples](https://runmaestro-feat-autonomous-manager-agent.mintlify.app/maestro-cue-examples.md): Real-world Maestro Cue configurations for common automation workflows.
- [Case Study: The Karpathy Loop](https://runmaestro-feat-autonomous-manager-agent.mintlify.app/maestro-cue-karpathy-loop.md): Build a self-improving agent on top of Cue - score every run, detect drift, propose program edits, apply on approval.
- [Case Study: Maestro Marketing Pipeline](https://runmaestro-feat-autonomous-manager-agent.mintlify.app/maestro-cue-marketing-example.md): How @RunMaestroAI's eight-chain Cue pipeline runs a self-tuning Twitter marketing loop in production.
- [MCP Server](https://runmaestro-feat-autonomous-manager-agent.mintlify.app/mcp-server.md): Connect AI applications to Maestro's documentation knowledge base using the Model Context Protocol.
- [Memories](https://runmaestro-feat-autonomous-manager-agent.mintlify.app/memories.md): Browse and edit per-project persistent memory for Claude Code agents from a dedicated viewer in the Maestro header.
- [Multiple Claude Accounts](https://runmaestro-feat-autonomous-manager-agent.mintlify.app/multi-claude.md): Run multiple Claude Code Max subscriptions simultaneously in Maestro.
- [OpenSpec Commands](https://runmaestro-feat-autonomous-manager-agent.mintlify.app/openspec-commands.md): Spec-driven development workflow for managing code changes with AI-assisted proposal, implementation, and archival.
- [Performance Profiling](https://runmaestro-feat-autonomous-manager-agent.mintlify.app/performance-profiling.md): Capture a React DevTools performance profile to help diagnose UI slowness in Maestro.
- [Playbook Exchange](https://runmaestro-feat-autonomous-manager-agent.mintlify.app/playbook-exchange.md): Browse, preview, and import community playbooks from the Maestro Playbook Exchange.
- [Prompt Customization](https://runmaestro-feat-autonomous-manager-agent.mintlify.app/prompt-customization.md): Customize the system prompts that control how Maestro's AI features behave.
- [Provider Notes](https://runmaestro-feat-autonomous-manager-agent.mintlify.app/provider-notes.md): Feature differences between Claude Code, Codex (OpenAI), and OpenCode providers.
- [Release Notes](https://runmaestro-feat-autonomous-manager-agent.mintlify.app/releases.md): Version history and changelog for Maestro releases
- [Themes Gallery](https://runmaestro-feat-autonomous-manager-agent.mintlify.app/screenshots.md): Preview Maestro's 18 beautiful themes including Dracula, Nord, Tokyo Night, and custom Vibe themes.
- [Slash Commands](https://runmaestro-feat-autonomous-manager-agent.mintlify.app/slash-commands.md): Create custom slash commands with template variables for your AI workflows.
- [Spec-Kit Commands](https://runmaestro-feat-autonomous-manager-agent.mintlify.app/speckit-commands.md): Structured specification workflow for AI-assisted development using GitHub's spec-kit methodology.
- [SSH Remote Execution](https://runmaestro-feat-autonomous-manager-agent.mintlify.app/ssh-remote-execution.md): Run AI agents on remote hosts via SSH for access to powerful machines or specialized tools.
- [Maestro Symphony](https://runmaestro-feat-autonomous-manager-agent.mintlify.app/symphony.md): Contribute to open source projects by donating AI tokens through Maestro Symphony.
- [Troubleshooting & Support](https://runmaestro-feat-autonomous-manager-agent.mintlify.app/troubleshooting.md): System logs, process monitor, debug packages, and how to get help with Maestro.
- [Usage Dashboard](https://runmaestro-feat-autonomous-manager-agent.mintlify.app/usage-dashboard.md): Track and analyze your AI agent usage patterns with comprehensive analytics and visualizations.