Command Reference

brainbase orchestration

Create, pull, and push multi-agent graphs. See Orchestrations for the concept and the orchestration manifest for the full YAML schema. orch is an alias for orchestration.

brainbase orchestration create

Claim a local brainbase-orchestration.yaml and create the orchestration in the cloud. Every declared member must already have a linked checkout under agents/<slug>/. The command validates the graph and schedule triggers, attaches the existing members, creates edges, edge settings, and schedule triggers, then writes gitignored link and sync state.

bash

brainbase orchestration create
brainbase orchestration create --org <org-id-or-slug> --team <team-id> --yes

Flag	Description
`--org <id-or-slug>`	Create in this organization.
`--team <id>`	Create in this team.
`--yes`, `-y`	Skip the creation confirmation.

brainbase orchestration list

List orchestrations under a team. --org accepts an organization ID or slug; --team accepts a team ID. Note the CLI's vocab inversion: --org maps to the DB teams.id and --team maps to the DB groups.id.

bash

brainbase orchestration list
brainbase orchestration list --org <org-id-or-slug> --team <team-id>

Flag	Description
`--org <id-or-slug>`	List within this organization.
`--team <id>`	List within this team.

brainbase orchestration pull <id>

Recursively fetch an orchestration plus every member agent. Pull preserves edge settings, materializes member runtime configuration, writes schedule triggers in their writable normalized form, and retains non-schedule app triggers as read-only context.

bash

brainbase orchestration pull <orchestration-id>
brainbase orchestration pull <orchestration-id> --harness codex --yes

Flag	Description
`--harness <id>`	Harness for newly-created member folders (default `claude-code`).
`--yes`, `-y`	Skip confirmation prompts.

brainbase orchestration push

Recursively push each member agent, then update the graph: membership, edges, edge settings, and schedule triggers. Use --graph-only to update that graph without pushing member-agent content. Non-schedule triggers are preserved in YAML but ignored by push.

bash

brainbase orchestration push
brainbase orchestration push --graph-only

Flag	Description
`--graph-only`	Push members, edges, edge settings, and schedule triggers, but not member-agent content.
`--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.

bash

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 membership, edge description/payload/settings, and schedule trigger drift. Status also reports missing or stale member checkouts and cloud revision drift since the last pull. Schedule drift compares the UUID node, active state, normalized config, and target edges; non-schedule triggers are not diffed.

bash

brainbase orchestration status