Skip to content
maestro

Install

Install with one command

Section titled “Install with one command”

Run this on a machine with Git and Bun:

Terminal window
curl -fsSL https://maestro.maccredyreina.me/install.sh | sh

The script clones the main branch into ~/.maestro/source, runs the installer from that checkout, and leaves the source record that future updates follow.

Choose a source directory or branch

Section titled “Choose a source directory or branch”

Set MAESTRO_SOURCE_DIR to replace the default source checkout and MAESTRO_REF to replace the default main branch. The installer refuses an existing source directory that is not a Git checkout.

Install from a checkout

Section titled “Install from a checkout”

From a Maestro checkout, run:

Terminal window
bun bin/maestro.ts install

Installation copies the runtime into ~/.maestro/runtime, writes the shim at ~/.local/bin/maestro, records the source in ~/.maestro/source.json, wires the current repository, and scaffolds the Supervisor room at ~/maestro. The room includes the canonical SLP Workspace Pack at ~/maestro/SLP.md.

Verify

Section titled “Verify”

Read the installed version and run the read-only diagnostic:

Terminal window
maestro version
maestro doctor

maestro doctor checks the shim, runtime stamp, recorded source, repository wiring, permissions, the Claude seat token, and store access. It exits zero when the report is healthy and names the repair command when the fix is mechanical.

Update

Section titled “Update”
Terminal window
maestro update

Update fast-forwards the recorded source checkout and resynchronizes the runtime. It refuses a dirty, diverged, missing, detached, or unreachable source without partially updating the runtime.

Remove repository wiring

Section titled “Remove repository wiring”
Terminal window
maestro uninstall

Uninstall removes Maestro-managed hooks, settings keys, and mirror blocks from the current repository, the rendered maestro-* profile files and the Claude seat config dirs under ~/.maestro/claude/. It does not delete repository data, the machine runtime, the shim, or the Supervisor room.

Install Herdr for SLP

Section titled “Install Herdr for SLP”

Team Supervisor, Lead, Peer, and the runtime pane require Herdr 0.8.2 or newer. Install Herdr separately:

Terminal window
curl -fsSL https://herdr.dev/install.sh | sh

Maestro remains the durable record. Herdr owns workspace and pane runtime, agent lifecycle, prompting, wake-up, and pane closure. Continue with SLP setup and storage to start a team and see which data belongs to the Hub, project, and runtime.