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/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"
```
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 |