Getting started

Choose the path that matches how you will use Maestro:

• Development checkout: Node, Git and the source repository.
• Packaged Windows app: no Node/npm is needed to launch the app.

For a source checkout, the minimum path is:

git clone https://github.com/Octomynd/octomynd-maestro.git
cd octomynd-maestro
npm install
Copy-Item .env.example .env.local
npm run smoke
npm run dev:platform

Then open http://127.0.0.1:4788, go to Providers, connect at least one provider, and register a Git project. The first-task walkthrough continues from there.

Before the first task

• Git must be installed and the project must be a Git repository.
• The project’s own dependencies should already be installed if its validation needs TypeScript, Vitest or a native runtime. Maestro does not run npm install inside the managed project.
• Keep the project checkout clean before preparation; Maestro creates a separate worktree for the task.
• Provider authentication belongs to the provider. Maestro only detects and invokes the configured CLI or endpoint.

If the smoke check or provider scan fails, use Troubleshooting before creating work.