tinhtran24/maestro / backend/internal/skillassets/using-maestro
using-maestro
VerifiedMaestro CLI Catalog
maestro is a thin CLI over the local Maestro daemon. Every command is maestro <command> --help for the authoritative flag list.
| Command | What it does | When to use | Details |
|---|---|---|---|
spawn | Spawn a worker agent in a fresh git worktree | Starting a new task or issue | commands/spawn.md |
session | Manage agent sessions (list, kill, rename, restore, etc.) | Inspecting or controlling running/terminated sessions | commands/session.md |
project | Register, inspect, configure, or remove projects | Setting up or managing repos Maestro knows about | commands/project.md |
orchestrator | List orchestrator sessions | Viewing which sessions are orchestrators | commands/orchestrator.md |
review | Submit a reviewer result for a worker's PR | Completing a code review loop | commands/review.md |
send | Send a message to a running agent session | Correcting or directing a live agent | commands/send.md |
preview | Open a URL in the desktop browser panel | Demoing a local server or file from inside a session | commands/preview.md |
start | Fetch (if needed) and open the Maestro desktop app | Launching the app | commands/start.md |
stop | Stop the Maestro daemon | Shutting down Maestro | commands/stop.md |
status | Show daemon status | Verifying the daemon is up and healthy | commands/status.md |
doctor | Run local health checks | Diagnosing Maestro setup problems | commands/doctor.md |
import | Import projects from a legacy Maestro install | Migrating from the old flat-file store | commands/import.md |
version | Print version information | Checking installed version | - |
completion | Generate shell completion scripts | Setting up tab completion | - |
Conventions
- Most read commands accept
--jsonfor machine-readable output. -p / --projectscopes session subcommand lookups to one project.- Session and project ids are shown by
maestro session lsandmaestro project ls. --agentis an alias for--harnessonmaestro spawn.- Every command accepts
-h / --helpfor the full flag list.
See references.md for natural-language-to-command mappings.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 197k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |