- Fix logo/favicon paths (build/ → assets/) and copy icons to docs/assets/ - Add page-level metadata (description, icon) to all 19 documentation pages - Fix broken numbered list formatting in about/overview.md - Embed YouTube walkthrough videos in index.md - Standardize terminology: Agent (Maestro workspace), Provider (Claude/Codex/OpenCode), Session/Tab (conversation) - Update Key Concepts table with clear definitions - Redistribute screenshots to relevant pages (git, keyboard shortcuts, general usage) - Transform screenshots.md into Themes Gallery page - Add git diff/logs screenshots to git-worktrees.md - Add command palette screenshot to keyboard-shortcuts.md - Add session management screenshot to general-usage.md Claude ID: ad65a8b7-fc6f-4ebc-86be-ec86f66a0120 Maestro ID: b9bc0d08-5be2-4fdf-93cd-5618a8d53b35
1.1 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
Maestro supports Claude Code, OpenAI Codex, and OpenCode as providers. 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 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.