Skip to content
maestro

Quick start

1. Install Maestro

Section titled “1. Install Maestro”

In the repository you want Maestro to wire and register, run:

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

2. Read the current session

Section titled “2. Read the current session”
Terminal window
maestro status

Status shows the current session, live peers, and held work.

3. Record one bounded task

Section titled “3. Record one bounded task”
Terminal window
maestro work add "Document the install path" --kind task --atomic-reason "One bounded documentation change" --acceptance "README links to the installer"

The command prints the new work ID. In a fresh repository it is w1; use the ID printed in your repository in the next commands.

4. Take the lease

Section titled “4. Take the lease”
Terminal window
maestro work start w1

Make the accepted change and run the check that could falsify it.

5. Complete with paired evidence

Section titled “5. Complete with paired evidence”
Terminal window
maestro work done w1 --claim "docs: README links to the installer" --proof "source: rg -n 'install.sh' README.md"

The claim states the observable result. The proof names the evidence layer and the falsifier. Enabled policies can require a pair, a child breakdown, or a returned dispatch before completion.

6. Read what is next

Section titled “6. Read what is next”
Terminal window
maestro ready

Ready lists work that can start and names the gates blocking other items.