Core Concepts

Orchestrations

An orchestration is a graph of agents that work together. The CLI treats the orchestration and its member agents as one unit: a single pull recursively fetches the graph plus every member agent, and a single push updates each member before updating the graph itself.

Commands

bash

brainbase orchestration list             # list orchestrations under a team
brainbase orchestration pull <id>        # fetch the graph + every member agent
brainbase orchestration push             # push each member, then the graph
brainbase orchestration status           # preview what would push / pull

Shorthand

orch is an alias for orchestration — brainbase orch list works too.

Updating only the graph

Pass --graph-only to push to update the orchestration graph (edges, triggers, wiring) without pushing each member agent's content. Use it when you've only rewired the graph and don't want to re-push unchanged members.

bash

brainbase orchestration push --graph-only

Adding a member agent

add-agent <name> (alias add) creates a new member agent in the orchestration, wires its edges with --from and --to (each repeatable), and pushes the result. Pass --no-push to stage the change locally without pushing.

bash

brainbase orchestration add-agent triage --from intake --to resolver
brainbase orch add researcher --to writer --no-push    # stage without pushing

Scope a listing to a specific org or team with --org <id> and --team <id>.