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