Getting Started

Get Maestro running on your Mac in a few minutes.

Requirements

Step 1: Install Claude Code

Maestro uses Claude Code under the hood to run AI agents. You need it installed and authenticated before using Maestro.

npm install -g @anthropic-ai/claude-code

After installing, run claude in your terminal once to authenticate with your Anthropic account. Maestro will auto-detect it from your PATH.

See the full Claude Code setup guide for details.

Step 2: Download Maestro

Download the latest release and drag Maestro.app into your Applications folder.

Download Maestro.dmg

On first launch, macOS may warn about an unidentified developer. Right-click the app and select "Open" to bypass this.

Step 3: First Run

  1. Open Maestro
  2. Go to Settings — Claude Code path is auto-detected if it's in your PATH
  3. Create a new project and point it to your workspace directory
  4. Add a task describing what you want built
  5. Click Run Agent and watch it work

Tips

  • Break your project into small, focused tasks for best results
  • Use the Review column to inspect changes before merging
  • You can send follow-up messages to running agents to steer their work
  • Enable "isolated workspaces" in project settings to give each task its own git worktree