Your first task
1. Connect a provider
Section titled “1. Connect a provider”Open Providers and use the provider’s official login flow, or configure an API key/local endpoint. Maestro can rescan the machine after you install a CLI; it does not copy another user’s login session. One ready provider is enough for a basic task.
2. Register the project
Section titled “2. Register the project”In Projects, add a local Git repository or a GitHub repository URL. A project must have a valid Git checkout and a detectable base branch. Resolve a dirty worktree or Git errors before preparing.
3. Create and prepare
Section titled “3. Create and prepare”Create a task with the actual outcome you want, for example:
Add a monthly expense summary to the existing finance dashboard.The original request remains in the database; Maestro derives a short display and PR title. Select
the task and choose Prepare. This creates a branch such as
maestro/task-<id>-<slug> in the configured execution/worktrees root.
4. Start the Goal
Section titled “4. Start the Goal”Choose Start goal or run:
maestro.cmd task start <task-id>The Goal records each phase and step. The task can be watched in the Dashboard or with:
maestro.cmd task logs <task-id> --follow5. Review the result
Section titled “5. Review the result”When delivery succeeds, Maestro runs its deterministic checks, pushes the task branch and opens a draft pull request. Review the changed files, test evidence and secret scan in Awaiting review. An approved standalone PR is marked ready on GitHub; the merge itself remains a human action.