tinhtran24/maestro / backend/internal/skillassets/using-maestro
using-maestro
Verified| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 2.8 KB |
| commands/doctor.md | markdown | 420 B |
| commands/import.md | markdown | 998 B |
| commands/orchestrator.md | markdown | 526 B |
| commands/preview.md | markdown | 1.1 KB |
| commands/project.md | markdown | 4.0 KB |
| commands/review.md | markdown | 1.2 KB |
| commands/send.md | markdown | 680 B |
| commands/session.md | markdown | 3.3 KB |
| commands/spawn.md | markdown | 1.6 KB |
| commands/start.md | markdown | 545 B |
| commands/status.md | markdown | 420 B |
| commands/stop.md | markdown | 386 B |
| references.md | markdown | 1.5 KB |
commands/spawn.md
View on GitHub# to spawn
Spawn a worker agent session in a registered project. The session runs the chosen agent in a fresh git worktree. Register the project first with `maestro project add`.
## Syntax
```
maestro spawn [flags]
```
## Flags
| Flag | Meaning | Default / Required |
|---|---|---|
| `--branch string` | Branch for the session worktree | `maestro/<session-id>/root` |
| `--claim-pr string` | Immediately claim an existing PR for the spawned session | - |
| `--harness string` | Agent harness to use (see list below) | Project `worker.agent`; required if the project has none |
| `--issue string` | Issue id to associate with the session | - |
| `--name string` | Display name shown in the sidebar (max 20 characters) | Required |
| `--no-takeover` | Refuse if another active session owns the claimed PR (requires `--claim-pr`) | - |
| `--project string` | Project id to spawn the session in | Required |
| `--prompt string` | Initial prompt for the agent | - |
`--agent` is an alias for `--harness`.
Available harnesses: `claude-code`, `codex`, `aider`, `opencode`, `grok`, `droid`, `amp`, `agy`, `crush`, `cursor`, `qwen`, `copilot`, `goose`, `auggie`, `continue`, `devin`, `cline`, `kimi`, `kiro`, `kilocode`, `vibe`, `pi`, `autohand`.
## Examples
```bash
# Spawn a worker for issue 142 in the maestro project
maestro spawn --project maestro --issue 142 --name "fix-session-leak" --prompt "Fix the session leak described in issue 142. Branch off upstream/main."
```
```bash
# Spawn a worker and immediately claim an open PR
maestro spawn --project maestro --name "review-pr-88" --claim-pr 88 --harness claude-code
```
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: 198k | 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 |