Maestro CLI

Install the client

One maestro daemon — version 0.1.23, built 2026-05-23T02:02:54Z. Pick the install method that matches your platform.

Quick install

Detects your OS + architecture, downloads the matching archive, drops maestro on PATH.

macOS · Linux

recommended 
curl -fsSL https://maestro.makerman.co/install.sh | sh

Windows · PowerShell

irm https://maestro.makerman.co/install.ps1 | iex

Package managers

🍺 Homebrew

macOS · Linuxbrew

brew tap maestro-dev/homebrew \
  https://gitlab.com/maestro-dev/homebrew.git
brew install maestro-dev/homebrew/maestro

One-shot: brew install --formula https://gitlab.com/maestro-dev/homebrew/-/raw/main/Formula/maestro.rb

📦 npm

Node.js

npm install -g maestro-makerman

Wrapper source: npm/ (publish from this build).

🐍 pip

Python ≥ 3.8

pip install maestro-makerman

Wrapper source: pip/ (publish from this build).

🦀 Cargo (from source)

cargo install --git https://gitlab.com/maestro-dev/maestro maestro

Builds the binary on the host — needs a Rust toolchain.

Direct downloads

Released archives + SHA-256 — verify against SHA256SUMS.

Platform Archive Size SHA-256

macOS

Apple Silicon (arm64)

 maestro-0.1.23-darwin-aarch64.tar.gz 7.7 MB 375df9aea33c8d4ad6171ee1… Download

Linux

x86_64

 maestro-0.1.23-linux-x86_64.tar.gz 7.5 MB 45ecbdc257e7b10781851e83… Download

Linux

arm64

 maestro-0.1.23-linux-aarch64.tar.gz 6.9 MB 0fcec3261d4c01b76183fa41… Download

Windows

x86_64

 maestro-0.1.23-windows-x86_64.zip 9.7 MB b442b2fa90adc03ceedd849f… Download

Manifest: latest.json

After install

  1. Get an invite token from Studio → Settings → Tokens.
  2. maestro auth <invite-token> — stores the bearer in your OS keyring.
  3. cd into a repo, then maestro connect — auto-detects the project from the git remote.