351299bdd1
- Wizard now saves generated docs under `Auto Run Docs/Initiation/` for clarity 📁 - Onboarding copy refresh: “Auto Run Playbook” terminology replaces “document” consistently 📝 - Claude parser now extracts and streams extended “thinking” blocks reliably 🧠 - Added full test coverage for thinking, redaction, and tool-use parsing paths ✅ - Wizard modal gains a real focus trap for rock-solid keyboard navigation ⌨️ - Wizard buttons now show accessible focus rings matching theme colors 🎯 - Phase Review: Escape closes document dropdown before modal closes 🛡️ - Phase Review: cycle multiple generated documents with ⌘/Ctrl+Shift+[ ] shortcuts 🔁 - Directory step: Enter on Browse triggers browse, not accidental “Continue” 🗂️ - Auto Run prompts upgraded with token-efficient task grouping rules and examples ⚡
2.2 KiB
title, description, icon
| title | description | icon |
|---|---|---|
| Getting Started | Get from install to your first productive session with Maestro in minutes. | rocket |
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. Create an agent (or use the Wizard)
Maestro supports Claude Code, OpenAI Codex, and OpenCode as providers. Make sure at least one is installed and authenticated.
Option A: Quick Setup Create your first agent manually using the + button in the sidebar.
Option B: Onboarding Wizard (Recommended for new users)
Press Cmd+Shift+N / Ctrl+Shift+N to launch the Onboarding Wizard, which guides you through:
- Selecting an AI provider
- Choosing your project directory
- Having a discovery conversation where the AI learns about your project
- Generating an initial Auto Run Playbook with tasks
The Wizard creates a fully configured agent with an Auto Run document folder ready to go. Generated documents are saved to an Initiation/ subfolder within Auto Run Docs/ to keep them organized separately from documents you create later.
Introductory Tour
After completing the Wizard, you'll be offered an Introductory Tour that highlights key UI elements:
- The AI Terminal and how to interact with it
- The Auto Run panel and how batch processing works
- File Explorer and preview features
- Keyboard shortcuts for power users
You can skip the tour and access it later via Quick Actions (Cmd+K / Ctrl+K) → "Start Tour".
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 conversation
Use the AI Terminal to talk with your AI provider, and the Command Terminal for shell commands. Toggle between them with Cmd+J / Ctrl+J. Each tab in the AI Terminal is a separate session.
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.