Getting started

Quickstart

Install the CLI on your machine and connect it to your Studio account.

Maestro Studio is a hosted service — you sign in at maestro.makerman.co, no install needed. The piece that runs on your machine is the maestro CLI: it auto-detects the git repo, connects to Studio over WSS, and executes dispatched tasks through your chosen AI provider.

Install the CLI

Pick whichever channel matches your stack — pre-built binaries for macOS, Linux and Windows. The Download page lists every option (curl|sh, Homebrew, npm, pip, cargo, direct archive).

shell 
curl -fsSL https://maestro.makerman.co/install.sh | sh
First-run path
  1. 1

    Sign in to Studio

    /register

    Register or sign in at maestro.makerman.co; create a workspace and a project linked to a git repo.

  2. 2

    Generate a CLI invite token

    Settings → Tokens

    Studio issues a one-time JWT invite from Settings → Tokens.

  3. 3

    Redeem on the machine

    maestro auth

    `maestro auth <token>` stores identity + access/refresh tokens in the OS keyring. Studio URL is baked in — no prompts.

  4. 4

    Connect & analyze

    maestro connect

    `cd` into your repo, then `maestro connect` (auto-detects the project) and `maestro analyze` (builds the knowledge base).

  5. Loops back until the verdict is approved

Bring your own AI provider — export ANTHROPIC_API_KEY (or ANTHROPIC_BASE_URL / ANTHROPIC_AUTH_TOKEN, OpenAI, Gemini, etc.) before maestro connect. Keys stay in your OS keyring; Maestro never sees them.