# Maestro

> Multi-agent orchestration framework for Claude Code. Runs five parallel Claude Code squads against a shared codebase — specialised roles, dependency-ordered work, quality gates, and security scanning — entirely on your machine with your Anthropic API key.

Maestro is a Python CLI (`pip install maestro`) that coordinates up to five concurrent Claude Code sessions in a single workspace. It is **not** a SaaS product. Your code never leaves your machine; your Anthropic key is yours.

## Product summary

- **What it does:** Orchestrates up to five Claude Code squads in parallel against a shared Git repository.
- **How it works:** A voyage (sprint) contains orders (tasks). Each order targets one of six specialised roles: PLN (Planner), BLD (Builder), TST (Tester), DOC (Scribe), SEC (Security Reviewer), REL (Releaser). The dispatcher routes orders to the right role, launches Claude Code sessions as crews, and enforces quality gates between roles.
- **Key constraint:** Entirely local. The only external network calls are to `api.anthropic.com` (your key) and, optionally, `api.github.com`. No Maestro server exists in the request path.
- **Licence model:** Community (free, 1 crew, 3 roles) · Pro ($9/user/mo, 5 crews, 6 roles) · Team ($15/user/mo, 5+ seats) · Enterprise (custom).

## Core concepts

- **Voyage:** A sprint or work package. One voyage = one Git branch = one PR.
- **Order:** A unit of work assigned to a role. Lives in `.mso/queues/orders/` as a JSON file.
- **Crew:** A Claude Code session running a single order. Up to 5 crews run concurrently.
- **Role sequence:** PLN → BLD → TST → DOC → SEC → REL. Dependency ordering is enforced.
- **Quality gates:** Structured acceptance criteria attach to every order. TST validates each; REL refuses to merge unless all gates pass.
- **Pretool secret detection:** Scans every file write for AWS keys, GitHub PATs, OpenAI tokens, JWTs, and more. Fail-closed.
- **OWASP/CWE scanning:** Posttool scanner checks Python for SQL injection, XSS, path traversal, hardcoded creds.

## CLI quick reference

```
pip install maestro --extra-index-url https://maestrodevs.github.io/simple/
mso licence activate <KEY>
mso init --project MYPROJ
mso voyage create "Sprint title"
mso order "Add SSO login" --role BLD
mso dispatch --max-crews 5
mso status
mso security scan
```

## Personas

Maestro ships five built-in personas (nautical, game-rangers, navy-seals, storm-troopers, default). Each persona changes squad names, CLI flavour, and prompt terminology — the orchestration mechanics are identical.

## Data / privacy

- No Maestro server. Workspace state lives in `.mso/` next to your code.
- Telemetry is off by default (opt-in, allow-listed event names only — never code or prompts).
- Air-gapped mode supported: set `dataResidency.mode: air-gapped` to refuse all outbound HTTP except localhost.
- Licence validation calls `licence.maestrodevs.com` with a 14-day offline grace.

## Pricing

| Plan | Price | Crews | Roles |
|------|-------|-------|-------|
| Community | Free | 1 | 3 (PLN/BLD/TST) |
| Pro | $9/user/mo | 5 | 6 |
| Team | $15/user/mo (5+ seats) | 5 | 6 |
| Enterprise | Custom | 5+ | 6 |

All plans: BYOK. You pay Anthropic directly for token usage.

## Links

- Docs: https://docs.maestrodevs.com
- Pricing: https://maestrodevs.com/pricing
- Trust & security: https://maestrodevs.com/trust
- Contact / sales: https://maestrodevs.com/contact
- Install (wheel index): https://maestrodevs.github.io/simple/