Skip to content

tinhtran24/maestro / backend/internal/skillassets/using-maestro

using-maestro

Verified

FileKindSize
SKILL.mdskill md2.8 KB
commands/doctor.mdmarkdown420 B
commands/import.mdmarkdown998 B
commands/orchestrator.mdmarkdown526 B
commands/preview.mdmarkdown1.1 KB
commands/project.mdmarkdown4.0 KB
commands/review.mdmarkdown1.2 KB
commands/send.mdmarkdown680 B
commands/session.mdmarkdown3.3 KB
commands/spawn.mdmarkdown1.6 KB
commands/start.mdmarkdown545 B
commands/status.mdmarkdown420 B
commands/stop.mdmarkdown386 B
references.mdmarkdown1.5 KB

commands/project.md

View on GitHub
# to project

Manage projects: register repos, inspect, configure per-project settings, and remove.

## Syntax

```
maestro project <subcommand> [args] [flags]
```

## Subcommands

---

### to project add

Register a local git repo as a project so sessions can be spawned in it. The path must be an existing git repository on disk. With `--as-workspace`, the path may be a parent folder containing direct child git repositories; Maestro initializes/adopts the parent as the root repo and gitignores children.

**Syntax:**
```
maestro project add [flags]
```

**Flags:**

| Flag | Meaning | Default / Required |
|---|---|---|
| `--as-workspace` | Register a parent folder as a workspace project (root-as-repo plus direct child repos) | - |
| `--id string` | Project id | Derived by the daemon from the path |
| `--name string` | Display name | - |
| `--orchestrator-agent string` | Default orchestrator session agent | - |
| `--path string` | Absolute path to the local git repo | Required |
| `--worker-agent string` | Default worker session agent | - |

**Examples:**

```bash
# Register a repo as a project
maestro project add --path /Users/harshit/Downloads/side-quests/maestro --name "maestro"
```

```bash
# Register a workspace (parent folder containing multiple repos)
maestro project add --path /Users/harshit/Downloads/side-quests --as-workspace --name "side-quests"
```

---

### to project ls

List registered projects. Aliases: `ls`, `list`.

**Syntax:**
```
maestro project ls [flags]
```

**Flags:**

| Flag | Meaning | Default / Required |
|---|---|---|
| `--json` | Output projects as JSON | - |

**Examples:**

```bash
# List all registered projects
maestro project ls
```

---

### to project get

Fetch one registered project.

**Syntax:**
```
maestro project get <id> [flags]
```

**Flags:**

| Flag | Meaning | Default / Required |
|---|---|---|
| `--json` | Output project as JSON | - |

**Examples:**

```bash
# Get details for the maestro project
maestro project get maestro
```

---

### to project rm

Remove a registered project. Aliases: `rm`, `remove`, `delete`.

**Syntax:**
```
maestro project rm <id> [flags]
```

**Flags:**

| Flag | Meaning | Default / Required |
|---|---|---|
| `--json` | Output removal result as JSON | - |
| `-y, --yes` | Skip confirmation prompt | - |

**Examples:**

```bash
# Remove a project (with confirmation)
maestro project rm maestro
```

```bash
# Remove without prompt
maestro project rm maestro -y
```

---

### to project set-config

Replace a project's per-project config (branch, session prefix, env, symlinks, post-create, agent model/permissions, role overrides). The config is resolved when a session spawns. Set fields via flags, pass the whole object with `--config-json`, or `--clear` to remove all config.

**Syntax:**
```
maestro project set-config <id> [flags]
```

**Flags:**

| Flag | Meaning | Default / Required |
|---|---|---|
| `--clear` | Clear all config | - |
| `--config-json string` | Full config as a JSON object (overrides field flags) | - |
| `--default-branch string` | Base branch new session worktrees are created from | - |
| `--env stringArray` | Env var `KEY=VALUE` forwarded into sessions (repeatable) | - |
| `--json` | Output the updated project as JSON | - |
| `--model string` | Agent model override (e.g. `claude-opus-4-5`) | - |
| `--orchestrator-agent string` | Harness override for orchestrator sessions | - |
| `--permission string` | Permission mode: `default`, `accept-edits`, `auto`, `bypass-permissions` | - |
| `--post-create stringArray` | Command to run after workspace creation (repeatable) | - |
| `--session-prefix string` | Displayed session-id prefix | - |
| `--symlink stringArray` | Repo-relative path to symlink into workspaces (repeatable) | - |
| `--worker-agent string` | Harness override for worker sessions | - |

**Examples:**

```bash
# Set default branch and model for a project
maestro project set-config maestro --default-branch main --model claude-opus-4-5
```

```bash
# Set an env var and a post-create command
maestro project set-config maestro --env "NODE_ENV=development" --post-create "npm 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: 198kUpdated Claude CodeCodexVerifiedInstall
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: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
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: 194kUpdated Claude CodeCodexVerifiedInstall