CLI (maestro-cli)

Fresh

Headless operation for cron jobs and CI/CD pipelines.

Installation

macOS

printf '#!/bin/bash\nnode "/Applications/Maestro.app/Contents/Resources/maestro-cli.js" "$@"\n' \
  | sudo tee /usr/local/bin/maestro-cli && sudo chmod +x /usr/local/bin/maestro-cli

Commands

Send Message

# Send to agent (returns JSON)
maestro-cli send <agent-id> "describe the authentication flow"

# Resume an existing session
maestro-cli send <agent-id> "add rate limiting" -s <session-id>

List Resources

maestro-cli list groups
maestro-cli list agents
maestro-cli list agents -g <group-id>
maestro-cli list sessions <agent-id>
maestro-cli list sessions <agent-id> -l 10 -k 0 -s "authentication"
maestro-cli list playbooks

Show Details

maestro-cli show agent <agent-id>
maestro-cli show playbook <playbook-id>

Run Playbooks

maestro-cli playbook <playbook-id>
maestro-cli playbook <playbook-id> --dry-run
maestro-cli playbook <playbook-id> --wait --verbose --json

Maintenance

maestro-cli clean playbooks

Features

• Partial ID matching — Type enough characters to be unique
• JSON output (--json) — Streams JSONL events for playbooks, structured JSON for other commands

Scheduling with Cron

# Run a playbook every hour
0 * * * * /usr/local/bin/maestro-cli playbook <playbook-id> --json >> /var/log/maestro.jsonl 2>&1

See Also

• Auto Run & Playbooks — Playbook feature reference
• Troubleshooting — Common issues