Command Reference
brainbase orchestration
Pull and push multi-agent graphs. See Orchestrations for the concept. orch is an alias for orchestration.
brainbase orchestration list
List orchestrations under a team. Scope with --org / --team. Note the CLI's vocab inversion: --org maps to the DB teams.id and --team maps to the DB groups.id.
brainbase orchestration list
brainbase orchestration list --team <team-id>
brainbase orchestration pull <id>
Recursively fetch an orchestration plus every member agent.
brainbase orchestration pull <orchestration-id>
brainbase orchestration push
Recursively push each member agent, then update the graph. Use --graph-only to update just the wiring.
brainbase orchestration push
brainbase orchestration push --graph-only
| Flag | Description |
|---|---|
| `--graph-only` | Update only the orchestration graph, not member agents. |
| `--yes` | Skip confirmation prompts. |
brainbase orchestration add-agent <name>
Create a new member agent, wire its edges into the graph, and push. add is an alias for add-agent.
brainbase orchestration add-agent researcher --from planner --to writer
| Flag | Description |
|---|---|
| `--from <agent>` | Source edge into the new agent (repeatable). |
| `--to <agent>` | Edge out of the new agent (repeatable). |
| `--description <text>` | Description for the new member agent. |
| `--schema <json>` | Edge payload schema. |
| `--harness <id>` | Target harness for the new member agent. |
| `--org <id>` | Scope to an org. |
| `--no-push` | Create and wire locally but skip the push. |
| `--yes` | Skip confirmation prompts. |
brainbase orchestration status
Preview what would push and what would pull.
brainbase orchestration status