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/session.md

View on GitHub
# to session

Manage agent sessions: list, inspect, rename, kill, restore, clean up, and claim PRs.

## Syntax

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

## Subcommands

---

### to session ls

List sessions.

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

**Flags:**

| Flag | Meaning | Default / Required |
|---|---|---|
| `-a, --all` | Include orchestrator sessions | - |
| `--include-terminated` | Include terminated sessions | - |
| `--json` | Output as JSON | - |
| `-p, --project string` | Filter by project ID | - |

**Examples:**

```bash
# List all active worker sessions
maestro session ls
```

```bash
# List all sessions including terminated, scoped to one project
maestro session ls --include-terminated -p maestro
```

---

### to session get

Fetch one session.

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

**Flags:**

| Flag | Meaning | Default / Required |
|---|---|---|
| `--json` | Output as JSON | - |
| `-p, --project string` | Project id to scope the lookup | - |

**Examples:**

```bash
# Get details for session mer-3
maestro session get mer-3
```

```bash
# Get session details as JSON
maestro session get mer-3 --json
```

---

### to session kill

Terminate a session.

**Syntax:**
```
maestro session kill <id> [flags]
```

**Flags:**

| Flag | Meaning | Default / Required |
|---|---|---|
| `-p, --project string` | Project id to scope the lookup | - |

**Examples:**

```bash
# Kill session mer-3
maestro session kill mer-3
```

---

### to session rename

Rename a session.

**Syntax:**
```
maestro session rename <id> <name> [flags]
```

**Flags:**

| Flag | Meaning | Default / Required |
|---|---|---|
| `-p, --project string` | Project id to scope the lookup | - |

**Examples:**

```bash
# Rename session mer-3 to a new display name
maestro session rename mer-3 "fix-auth-bug"
```

---

### to session restore

Relaunch a terminated session.

**Syntax:**
```
maestro session restore <id> [flags]
```

**Flags:**

| Flag | Meaning | Default / Required |
|---|---|---|
| `-p, --project string` | Project id to scope the lookup | - |

**Examples:**

```bash
# Restore a terminated session
maestro session restore mer-3
```

---

### to session cleanup

Clean up terminated sessions by reclaiming eligible workspaces. Dirty worktrees are skipped by the daemon.

**Syntax:**
```
maestro session cleanup [flags]
```

**Flags:**

| Flag | Meaning | Default / Required |
|---|---|---|
| `-p, --project string` | Filter by project ID | - |
| `-y, --yes` | Skip confirmation prompt | - |

**Examples:**

```bash
# Clean up all terminated sessions (skip prompt)
maestro session cleanup -y
```

```bash
# Clean up terminated sessions for one project
maestro session cleanup -p maestro
```

---

### to session claim-pr

Attach an existing PR to a session.

**Syntax:**
```
maestro session claim-pr <session-id> <pr-ref> [flags]
```

**Flags:**

| Flag | Meaning | Default / Required |
|---|---|---|
| `--json` | Output as JSON | - |
| `--no-takeover` | Refuse if another active session owns the PR | - |
| `-p, --project string` | Project id to scope the lookup | - |

**Examples:**

```bash
# Attach PR 88 to session mer-3
maestro session claim-pr mer-3 88
```

```bash
# Claim PR 88 but refuse if another session already owns it
maestro session claim-pr mer-3 88 --no-takeover
```
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