Maestro/docs/getting-started.md

title

title
Getting Started

This guide gets you from install to a first productive session with Maestro.

1. Install and launch

Follow the Installation instructions for your platform, then launch Maestro.

2. Connect an agent

Maestro supports Claude Code, OpenAI Codex, and OpenCode. Make sure at least one is installed and authenticated, then create your first agent in the sidebar.

3. Open a project

Point your new agent at a project directory. Maestro will detect git repos automatically and enable git-aware features like diffs, logs, and worktrees.

4. Start a session

Use the AI Terminal to talk with your agent, and the Command Terminal for shell commands. Toggle between them with Cmd+J / Ctrl+J.

5. Try Auto Run

Create a markdown checklist, then run it through Auto Run to see the spec-driven workflow in action. See Auto Run + Playbooks for a full walkthrough.